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

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

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

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

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

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

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

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

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

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

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

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

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

Місія:

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

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

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

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

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

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

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

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

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

• Які SEO наміри ми націлюємося з цією частиною — інформаційні або транзакційні?
• “Ця тема перетинається з існуючим початковим посібником. Чи варто нам оновлювати це, замість того, щоб публікувати щось нове?»
• «Хто є рецензентом технічної точності цієї статті перед тим, як вона вийде в ефір?»
• «Ця стаття є вічнозеленою — ми повинні планувати квартальний огляд, щоб мати приклади коду в актуальному стані»
• «Ми не маємо контенту для цієї персони — давайте приоритизуємо це в Q4»

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

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

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

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

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

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

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

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

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