Короткий огляд
Нам потрібен стислий, дієвий, SEO-дружній посібник, який навчить розробників Unity та QA, як захоплювати журнали Unity з мобільних пристроїв (Android & iOS) за допомогою Snapshots від Jahro (https://jahro.io). Залиште його коротким, корисним і написаним у стилі Jahro (чітко, впевнено, трохи зухвало, але не надто хитро).
Результати: документація в markdown (готова для сайту)
Для кого ми пишемо (ICP)
Основна аудиторія:
Інженери Unity (молодші → старші; 1–5 років досвіду), які працюють над мобільними іграми.
Інженери ручного QA, які тестують збірки мобільних ігор.
Дизайнери ігор та PM, яким потрібні відтворювані звіти про помилки.
Технічні/продуктові керівники малих студій, які хочуть покращити співпрацю між розробниками та QA.
Тон: короткий, прямий, технічний, де потрібно, але дружній — як старший розробник, який пояснює, як не витрачати час на журнали. Пишіть простою англійською для двомовних читачів.
Тема — загальний огляд
Мета: пояснити, що таке Snapshots, чому вони важливі для захоплення журналів Unity з мобільних пристроїв і як їх використовувати (крок за кроком). Цей посібник має відповідати документації https://jahro.io/docs/snapshots, але буде окремим посібником.
Цільова довжина: 1500–2500 слів (вичерпний, але зручний для перегляду).
SEO вимоги
Основні цільові ключові слова:
Журнали Unity з мобільних пристроїв
Журнал налагодження Unity
Журнали Unity Android
Журнали Unity iOS
Додаткові (використовуйте, де це доречно)
unity adb logcat, unity Xcode console, мобільне налагодження Unity, журнали пристроїв,
Результати повинні включати:
Пропонований URL slug (наприклад, /docs/snapshots-unity-logs-mobile-android-ios)
Meta title (≤ 60 символів) та meta description (120–155 символів)
Назва бокової панелі - до 30 символів
H1 (назва сторінки) та 3 альтернативні заголовки героя (короткі)
Природне використання ключових слів — уникайте перенасичення. Ставте за мету 1–2 появи основного ключового слова в заголовку/вступі + органічні появи в заголовках/тексті.
Правила формату SEO:
Довжина мета-опису 120–155 символів.
Використовуйте заголовки H2/H3, які містять ключові слова, де це природно.
Надайте 3–5 запропонованих цілей для внутрішніх посилань (Watcher, Commands).
Посилання та дослідження
Необхідні джерела дослідження:
Документація Unity про ведення журналів на пристроях (Android & iOS).
Відповідні теми на StackOverflow, Unity Forum та Reddit про проблеми з журналами пристроїв та тертя adb/Xcode.
Довгі посібники в стилі PostHog як посилання для тону/структури: https://posthog.com/tutorials/nextjs-cookie-banner
https://posthog.com/tutorials/embedded-analytics
https://posthog.com/blog/ai-community-answers
https://posthog.com/product-engineers/ab-testing-mistakes
Тон голосу та правила написання
Дотримуйтесь голосу Jahro:
Короткі, прямі речення. Одна ідея на речення.
Використовуйте “ви”, а не “ми”, де це можливо.
Уникайте зайвих слів і маркетингового шуму. Показуйте цінність конкретними результатами.
Використовуйте легкий шарм, де це доречно (дозволено “налагодження — це жах”).
Дотримуйтесь AIDA / PAS, де це корисно: почніть з проблеми, покажіть швидке рішення, потім кроки та докази.
Правило 100–3–1: читач повинен зрозуміти суть за 3 секунди / 1 екран.
Цілі — чому ми це публікуємо
SEO: зайняти позиції за запитом “Журнали Unity з мобільних пристроїв” та пов'язаними запитами.
Прийняття продукту: залучити нових та існуючих користувачів спробувати Snapshots і завершити перший знімок протягом 7 днів.
Контент для маркетингу: розсилка електронною поштою, onboarding, відповіді на форумах/Reddit/Quora та публікації в соціальних мережах.
Критерії успіху (вимірювальні / прийнятні)
Посібник приймається, коли виконуються всі ці умови:
✅ Доставлено в Markdown з frontmatter.
✅ Meta title ≤60 символів; meta description 120–155 символів.
✅ Запропоновано URL slug та присутній H1.
✅ Основні ключові слова з'являються в заголовку/вступі та принаймні двічі в тексті (природно).
✅ Включає покроковий “Захопіть свій перший Snapshot”, який може виконати інженер QA (без пропущених кроків).
✅ Перевірки читабельності: короткі абзаци, маркери та структура H2/H3.
✅ Тон відповідає голосу Jahro (ми перевіримо).
✅ Без плагіату; все оригінально або належним чином процитовано та вказано.
