Як написати технічну стратегію контенту англійською мовою

Технічна стратегія змісту — це документ, який пов’ язує те, що пише ваша команда, з тим, що має досягти ваш бізнес. Незалежно від того, чи працюєте ви у сфері відносин з розробниками, технічного маркетингу, документації або інженерії, написання цієї стратегії англійською мовою є обов’ язковим під час співпраці з глобальними командами або передачі ресурсів керівництву. Цей посібник допоможе вам освоїти словниковий запас і фрази, які вам знадобляться для написання професійної, переконливої стратегії технічного змісту.

Ключовий словник

** Аудит вмісту ** — систематичний перелік і оцінка існуючого вмісту для оцінки якості, актуальності і прогалин. “Перед плануванням нового вмісту, ми провели аудит вмісту і виявили, що 40% наших навчальних матеріалів були застарілими або дубльованими.”

** Стовп змісту ** — широка, основна тема, яка слугує основою для кластера пов’ язаного, більш специфічного змісту. “Наші три стовпи контенту - це впровадження розробників, посилання на API і найкращі практики - все, що ми пишемо, відповідає одному з них.”

** Редакційний календар ** — розклад, який відображає теми вмісту у відповідності до дат публікації, форматів і відповідальних авторів. “Редакторський календар на 3 квартал включає 12 блогів, 3 відео-уроки і 2 інтеграційні посібники.”

** Аудиторія персона ** — вигаданий, але заснований на дослідженнях профіль цільового читача, включаючи його роль, цілі і проблеми. “Ми визначили дві аудиторії: старший інженер, який оцінює наш API, і молодший розробник, який слідує за навчанням.”

Content funnel — the journey from awareness content (broad, educational) to consideration content (comparisons, deep dives) to conversion content (tutorials, quickstarts). “Вміст на верхівці каналу залучає нових розробників; вміст на нижній частині каналу перетворює їх на активних користувачів.”

** SEO intent ** — основна причина, з якої користувач виконує пошуковий запит (інформаційний, навігаційний або транзакційний). “Ця стаття блогу має інформаційний характер — читач хоче зрозуміти концепцію, а не купити продукт.”

** Проміжок у вмісту ** — тема, яку шукає ваша аудиторія, але про яку ви ще не опублікували вміст. “Аналіз конкурентів виявив значний прогалину в контенті: у нас немає посібників щодо міграції з REST до GraphQL.”

** Канал розповсюдження ** — платформа або середовище, за допомогою якого публікується та поширюється вміст (блог, бюлетень, YouTube, документи, конференційні доповіді). “Ми будемо розповсюджувати цей посібник через наш блог, розробницькі новини, і синдикацію на Dev.to.”

Створення стратегічного документа

Професійна технічна стратегія контенту зазвичай включає ці розділи. Використовувати цю мову при написанні кожного з них.

Місія:

• «Мета нашого технічного вмісту полягає в тому, щоб допомогти інженерам бекенду інтегрувати наш API за менше ніж 30 хвилин»
• «Наша місія вмісту: практичні, точні і оцінювані рекомендації для розробників, що будують на нашій платформі»

** Визначення аудиторії: **

• «Наша основна аудиторія — інженери середнього рівня в B2B SaaS компаніях, які оцінюють інструменти для розробників»
• «Вторинна аудиторія: інженерні менеджери оцінюють TCO і складність інтеграції»

** Типи та формати вмісту: **

• «Ми будемо виробляти три типи контенту: посилання на документацію, концептуальні посібники і покрокові вправи»
• «Довгі посібники (2000-3000 слів) будуть спрямовані на органічний пошук. Короткі статті (500-800 слів) будуть надходити в бюлетень»

Вимірювання впливу контенту

Використовуйте ці фрази під час показу показників швидкодії вмісту.

• «Ми відстежуємо три основні KPI: органічний трафік, час на сторінці і рівень активації розробників з документації»
• «Ця серія привела до 22% зростання пробних підписок з органічного пошуку за квартал»
• Наш середній час перебування на сторінці для навчальних матеріалів становить 7 хвилин, що свідчить про те, що розробники читають, а не відскакують
• «Атрибуція контенту показує, що 35% перетворених облікових записів залучалися до щонайменше трьох частин контенту перед підписанням»

Рецензії на твори письменників

• Які SEO наміри ми націлюємося з цією частиною — інформаційні або транзакційні?
• “Ця тема перетинається з існуючим початковим посібником. Чи варто нам оновлювати це, замість того, щоб публікувати щось нове?»
• «Хто є рецензентом технічної точності цієї статті перед тим, як вона вийде в ефір?»
• «Ця стаття є вічнозеленою — ми повинні планувати квартальний огляд, щоб мати приклади коду в актуальному стані»
• “We’re missing bottom-of-funnel content for this persona — let’s prioritise that in Q4.”

Професійні поради

1. ** Відокремте стратегію від тактики. ** Документ стратегії пояснює чому і кому; план змісту або календар пояснює що і коли. Не перебивайте їх.
2. ** Визначте кількість прогалин. ** « У нас є прогалина у змісті » — це слабке твердження. « Наш головний конкурент має 45 навчальних матеріалів на цю тему, а ми маємо 3 » — це переконливе твердження.
3. ** Визначити завершено. ** Для кожного типу вмісту визначте, як виглядає завершений, підданий публікації фрагмент — кількість слів, кроки перегляду, потрібні приклади коду.
4. ** Переглядайте щоквартально. ** Стратегия контента, написана один раз і ніколи не оновлена, швидко стає неактуальною. Розклад формальних переглядів.

Практичні вправи

1. Написати дворечення про мету інструменту для розробників, який допомагає командам стежити за продуктивністю API. Сфокусировались на аудитории и результате.
2. Ви знайшли прогалини у вмісту: ваша документація не містить опису обробки помилок. Напишіть 3- 4 речення, що пояснюють прогалини та їх вплив на бізнес, для стратегічного документа.
3. Ваш менеджер запитав вас, як ви будете оцінювати успіх нової серії навчальних матеріалів. Напишіть 4- 5 речень з описом ваших KPI і того, як ви будете стежити за ними.

Розробка мов програмування для ненаціональних розробників

Створення надійної стратегії технічного контенту не просто про обґрунтування тем; це про те, щоб повідомити ці ідеї чітко і ефективно вашій команді. Для розробників, які переходять на професійну англійську, тонкі відмінності у фразування і словниковий запас можуть бути особливо викликом. Легко ненавмисно передати невизначеність або відсутність авторитету, навіть коли ви володієте глибокими технічними знаннями. Розглянемо, як це можна зробити безпосередньо в документації з контент-стратегії - не тільки як додаткова думка, а як фундаментальний елемент.

Однією з поширених пасток є використання надмірно непевної мови. Замість того, щоб сказати «Я * думаю * аудит повинен зосередитись на … », спробуйте щось більш упевнене, наприклад, «Аудит повинен приоритизувати … » або «Ми рекомендуємо зосередитись на аудиті на … ». Остання негайно встановлює рекомендацію з певною мірою впевненості, що є ключовим у технічних обговореннях. Аналогічно, такі фрази як «Може бути корисним…» можуть звучати неохоче. Замініть його на «Досліджуємо…» або «Для забезпечення ясності, ми пропонуємо…». Ці зміни ненадовго підсилюють вашу роль як учасника і приймача рішень у процесі.

Крім того, зверніть увагу на те, як ви описуєте зворотній зв’ язок. Отримання конструктивної критики - часто доставляється через коментарі перегляду коду - є основною частиною професійного розвитку. Замість того, щоб реагувати у захисному ключі фразами на зразок « Я не розумію, чому це є проблемою », які можуть сприйматися як відкидання, спробуйте « Чи могли б ви розкрити конкретні проблеми, що стосуються цього розділу? » або « Я ціную ваші відгуки; чи могли б ви надати більше контексту щодо того, як це збігається з нашою загальною архітектурою? » Формування вашої відповіді демонструє відкритість до навчання і бажання поліпшити вашу роботу. У каналах Slack, де обговорюються описи PR, не вказуйте просто « Виправлено ваду ». Замість цього використовуйте щось на зразок: « Впроваджено виправлення для [ІД вади], яке вирішує [короткий опис проблеми] за допомогою [коротке пояснення рішення]. Ця зміна забезпечує [позитивний результат]»

Нарешті, пам’ятайте, що точність цінується в технічному спілкуванні. Уникайте нечітких термінів і віддавайте перевагу чітким визначенням. Якщо ви визначаєте типи вмісту, такі як «документація API» або «технічні навчальні матеріали», переконайтеся, що ці терміни послідовно визначені у вашому стратегічному документі, щоб уникнути плутанини. Регулярне переглядання вашого вмісту за допомогою лінзи людини, для якої мова не є рідною, може відкрити можливості для більшої ясності і впливу, зміцнити ваші загальні навички спілкування і, врешті- решт, сприяти більш продуктивному середовищу для роботи команди.