Po tym jak wybierzesz narzędzie może pojawić się pokusa, żeby od razu przejść do pełnego wdrożenia go w swojej organizacji. Ale moje doświadczenie i wiedza pozwoliły mi dawno temu dojść do wniosku, że nie jest to najlepszy pomysł.
Dla doświadczonego pisarza technicznego stworzenie release notes (czyli - spolszczając - not wydania) nie jest wielkim wyzwaniem. Tym bardziej, że jest to jeden ze standardowych typów dokumentacji, wymienianych kiedyś przez syllabus nieistniejącego już ITCQF®.
Bash (Bourne Again Shell) to złoty standard w świecie rozwoju oprogramowania. Ta powłoka systemowa, a upraszczając na potrzeby zrozumienia tematu, ta linia komend pozwala nam na wykonanie rozmaitych operacji na naszym komputerze.
Rzeczywistość współczesnego tech writingu to docs-as-code: Git, Markdown i Static Site Generators (SSG). Jak ma się w tym wszystkim odnaleźć tech writer? Moja odpowiedź brzmi: najlepiej tak, żeby nie stać się programistą.
Umiejętności miękkie są równie ważne jak techniczne, ponieważ to od nich zależy, czy dokumentacja będzie przyjazna w odbiorze i dopasowana do potrzeb użytkownika. W końcu dobra dokumentacja to nie tylko zestaw danych — to most między człowiekiem a technologią!