Krótki przegląd
Potrzebujemy zwięzłego, praktycznego, przyjaznego dla SEO przewodnika dokumentacyjnego, który nauczy programistów Unity i QA, jak przechwytywać logi Unity z urządzeń mobilnych (Android i iOS) za pomocą Snapshots od Jahro (https://jahro.io). Zachowaj to krótkie, użyteczne i napisane w głosie Jahro (jasne, pewne siebie, lekko zuchwałe, ale nie kiczowate).
Dostarczone materiały: dokumenty markdown (gotowe na stronę)
Dla kogo piszemy (ICP)
Główna publiczność:
Inżynierowie Unity (junior → senior; 1–5 lat doświadczenia) pracujący nad grami mobilnymi.
Inżynierowie QA manualnego testujący wersje gier mobilnych.
Projektanci gier i PM-owie, którzy potrzebują powtarzalnych raportów o błędach.
Liderzy technologiczni/produktowi w małych studiach, którzy chcą lepszej współpracy między deweloperami a QA.
Ton: krótki, bezpośredni, techniczny tam, gdzie to potrzebne, ale przyjazny — jak starszy programista wyjaśniający, jak przestać marnować czas na logi. Pisz prostym angielskim dla dwujęzycznych czytelników.
Temat — ogólny przegląd
Cel: wyjaśnić, czym są Snapshots, dlaczego są ważne do przechwytywania logów Unity z urządzeń mobilnych i dokładnie jak ich używać (krok po kroku). Ten przewodnik powinien spełniać dokumentację https://jahro.io/docs/snapshots, ale będzie osobnym przewodnikiem.
Docelowa długość: 1500–2500 słów (kompleksowy, ale łatwy do przeszukiwania).
Wymagania SEO
Główne cele słów kluczowych:
Logi Unity z urządzeń mobilnych
Log debugowania Unity
Logi Unity Android
Logi Unity iOS
Drugorzędne (użyj tam, gdzie to istotne)
unity adb logcat, unity Xcode console, mobile debug Unity, device logs,
Dostarczone materiały muszą zawierać:
Proponowany URL slug (np. /docs/snapshots-unity-logs-mobile-android-ios)
Tytuł meta (≤ 60 znaków) i opis meta (120–155 znaków)
Tytuł paska bocznego - do 30 znaków
H1 (tytuł strony) i 3 alternatywne nagłówki hero (krótkie)
Naturalne użycie słów kluczowych — unikaj nadmiaru. Dąż do 1–2 wystąpień głównego słowa kluczowego w tytule/wprowadzeniu + organicznych wystąpień w nagłówkach/treści.
Reguły formatu SEO:
Długość opisu meta 120–155 znaków.
Używaj nagłówków H2/H3, które zawierają słowa kluczowe tam, gdzie to naturalne.
Podaj 3–5 sugerowanych celów linków wewnętrznych (Watcher, Commands).
Źródła i badania
Wymagane źródła badań:
Dokumentacja Unity dotycząca logowania urządzeń (Android i iOS).
Relewantne wątki na StackOverflow, Unity Forum i Reddit dotyczące problemów z logami urządzeń oraz tarć adb/Xcode.
Przewodniki długie w stylu PostHog jako odniesienie dla tonu/struktury: 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
Ton głosu i zasady pisania
Podążaj za głosem Jahro:
Krótki, bezpośredni zdania. Jedna idea na zdanie.
Używaj „ty”, a nie „my”, gdzie to możliwe.
Unikaj pustych fraz i marketingowego szumu. Pokaż wartość poprzez konkretne wyniki.
Używaj lekkiego uroku tam, gdzie to odpowiednie (dozwolone „debugging sucks”).
Podążaj za AIDA / PAS tam, gdzie to pomocne: otwórz problem, pokaż szybkie rozwiązanie, a następnie kroki i dowody.
Reguła 100–3–1: czytelnik powinien zrozumieć punkt w ciągu 3 sekund / 1 ekranu.
Cele — dlaczego publikujemy to
SEO: zajmij miejsce dla „Logi Unity z urządzeń mobilnych” i pokrewnych zapytań.
Adopcja produktu: zachęć nowych i istniejących użytkowników do wypróbowania Snapshots i ukończenia pierwszego snapshotu w ciągu 7 dni.
Treść do marketingu: e-maile, onboarding, odpowiedzi na forum/Reddit/Quora oraz posty w mediach społecznościowych.
Kryteria sukcesu (mierzalne / akceptacja)
Przewodnik jest akceptowany, gdy spełnione są wszystkie te warunki:
✅ Dostarczony w Markdown z frontmatter.
✅ Tytuł meta ≤60 znaków; opis meta 120–155 znaków.
✅ Proponowany URL slug i obecny H1.
✅ Główne słowa kluczowe pojawiają się w tytule/wprowadzeniu i przynajmniej dwa razy w treści (naturalnie).
✅ Zawiera krok po kroku „Przechwyć swój pierwszy Snapshot”, który inżynier QA może śledzić (bez brakujących kroków).
✅ Kontrole czytelności: krótkie akapity, punkty i struktura H2/H3.
✅ Ton podąża za głosem Jahro (przejrzymy).
✅ Brak plagiatu; wszystko oryginalne lub odpowiednio cytowane i przypisane.
