Przestrzeń dla tworzących treści techniczne

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ł.

Jedni piszą w Wordzie, drudzy piszą w DITA, a trzeci twierdzą, że tylko docs-as-code ma sens. Tak naprawdę nie ma jednego uniwersalnego i zawsze najlepszego wyboru, a frazes "to zależy" niewiele wnosi. Dzisiaj nie będziemy odpowiadać na pytanie, jakie narzędzie jest najlepsze, tylko jak je wybrać.

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®.

Release notes i changelog to nie to samo. Choć wielu myli te pojęcia, to dwa odrębne dokumenty, które spełniają oddzielne cele.

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.