Technical writing

{{whyLabel}}: To branżowy standard definiujący ton, strukturę i gramatykę w dokumentacji IT.

{{howLabel}}:

• Skup się na sekcjach dotyczących 'Tone and Voice' oraz 'Punctuation'.
• Zanotuj zasady używania list punktowanych i wielkich liter.
• Przeanalizuj przykłady 'Do' i 'Don't'.

{{doneWhenLabel}}: Przeczytano kluczowe rozdziały i sporządzono jednostronicową ściągawkę z zasadami.

{{whyLabel}}: Większość nowoczesnej dokumentacji (Docs-as-Code) powstaje w formacie Markdown.

{{howLabel}}:

• Naucz się formatowania nagłówków, linków, tabel i bloków kodu.
• Przetestuj składnię w edytorze online (np. Dillinger).
• Stwórz plik README.md dla fikcyjnego projektu.

{{doneWhenLabel}}: Samodzielne stworzenie dokumentu zawierającego wszystkie elementy formatowania bez zaglądania do dokumentacji.

{{whyLabel}}: Upraszczanie języka jest kluczowe dla odbiorców międzynarodowych i tłumaczeń maszynowych.

{{howLabel}}:

• Zapoznaj się z normą ASD-STE100 (podstawowe założenia).
• Ćwicz zamianę strony biernej na czynną.
• Ogranicz używanie wieloznacznych czasowników (np. zamiast 'get' użyj 'obtain' lub 'receive').

{{doneWhenLabel}}: Przeredagowanie 5 skomplikowanych zdań technicznych na formę prostą i bezpośrednią.

{{whyLabel}}: VS Code to najpopularniejsze środowisko do edycji dokumentacji technicznej.

{{howLabel}}:

• Pobierz i zainstaluj VS Code.
• Dodaj rozszerzenia: 'Markdown All in One', 'Vale' (do sprawdzania stylu) oraz 'Code Spell Checker'.
• Skonfiguruj podgląd Markdown (Ctrl+Shift+V).

{{doneWhenLabel}}: Środowisko jest gotowe do pracy i poprawnie renderuje pliki .md.

{{whyLabel}}: Kontrola wersji jest niezbędna w pracy zespołowej nad dokumentacją.

{{howLabel}}:

• Zainstaluj Git lokalnie.
• Stwórz repozytorium o nazwie 'Technical-Writing-Portfolio'.
• Przećwicz komendy: git add, git commit, git push.

{{doneWhenLabel}}: Pierwszy plik Markdown został poprawnie wypchnięty do zdalnego repozytorium.

{{whyLabel}}: Dokumentowanie API to jedna z najlepiej płatnych nisz w technical writingu.

{{howLabel}}:

• Przeczytaj specyfikację OpenAPI 3.0 (podstawy).
• Przeanalizuj demo Swagger Petstore.
• Zrozum strukturę endpointów, parametrów i odpowiedzi (JSON).

{{doneWhenLabel}}: Potrafisz wyjaśnić różnicę między metodą GET a POST oraz opisać strukturę pliku YAML.

{{whyLabel}}: Realne próbki tekstu są ważniejsze dla rekrutera niż certyfikaty.

{{howLabel}}:

• Wybierz proste narzędzie CLI lub bibliotekę na GitHub.
• Opisz proces instalacji, konfiguracji i pierwszego użycia.
• Zastosuj strukturę: Cel, Wymagania, Kroki, Wynik.

{{doneWhenLabel}}: Dokument o długości 1-2 stron zapisany w formacie Markdown w Twoim repozytorium.

{{whyLabel}}: Technical writer musi umieć tłumaczyć zawiłe procesy, a nie tylko pisać instrukcje 'kliknij tutaj'.

{{howLabel}}:

• Wybierz temat (np. 'Jak działa uwierzytelnianie OAuth2').
• Stwórz diagram przepływu (użyj narzędzia typu Mermaid.js lub draw.io).
• Opisz proces językiem zrozumiałym dla początkującego programisty.

{{doneWhenLabel}}: Artykuł techniczny z co najmniej jednym schematem graficznym.

{{whyLabel}}: Profesjonalna prezentacja online buduje wiarygodność.

{{howLabel}}:

• Użyj generatora stron statycznych (np. Hugo lub Jekyll) lub prostego szablonu HTML.
• Podepnij swoje pliki Markdown pod stronę.
• Skonfiguruj GitHub Pages w ustawieniach repozytorium.

{{doneWhenLabel}}: Działający link URL prowadzący do Twojego publicznego portfolio.

{{whyLabel}}: Rekruterzy szukają kandydatów po konkretnych słowach kluczowych.

{{howLabel}}:

• Dodaj do nagłówka: 'Aspiring Technical Writer | Docs-as-Code | API Documentation'.
• W sekcji 'Featured' dodaj link do swojego portfolio na GitHub Pages.
• Opisz swoje projekty, używając terminologii technicznej (Markdown, Git, DITA).

{{doneWhenLabel}}: Profil zawiera co najmniej 5 słów kluczowych związanych z zawodem i link do portfolio.

{{whyLabel}}: To największa na świecie społeczność technical writerów, oferująca wsparcie i oferty pracy.

{{howLabel}}:

• Zarejestruj się na Slacku 'Write the Docs'.
• Przedstaw się na kanale #introductions.
• Przejrzyj kanał #career-advice i #jobs.

{{doneWhenLabel}}: Aktywne konto na Slacku i przeczytanie 10 ostatnich wątków dotyczących juniorów.

{{whyLabel}}: Bezpośredni kontakt z praktykami pozwala poznać realia firm i ukryty rynek pracy.

{{howLabel}}:

• Znajdź na LinkedIn 3 osoby pracujące jako Technical Writer (najlepiej w Twoim mieście/kraju).
• Wyślij spersonalizowaną wiadomość z prośbą o 15 minut rozmowy o ich ścieżce kariery.
• Przygotuj 3 konkretne pytania (np. 'Jakich narzędzi używacie na co dzień?').

{{doneWhenLabel}}: Wysłanie 10 zaproszeń i odbycie co najmniej jednej rozmowy (ustalony termin w kalendarzu).

{{whyLabel}}: Praktyka w procesie rekrutacyjnym jest niezbędna do zdobycia pracy.

{{howLabel}}:

• Znajdź oferty pracy (LinkedIn, Indeed, No Fluff Jobs).
• Dostosuj CV do każdej oferty, podkreślając znajomość narzędzi (Git, Markdown).
• Dołącz link do portfolio w liście motywacyjnym.

{{doneWhenLabel}}: Potwierdzenie wysłania 5 aplikacji.