Przewodnik po zrzutach ekranu (Jahro)

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.