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®.
Reuse wydaje się być Świętym Graalem technical writingu, ale w tym artykule chciałbym pokazać, jak ta popularna praktyka może zepsuć wyniki wyszukiwania.
Są książki, które biorą rzeczywistość za rogi i (cytując klasyka) „mówią, jak jest”. Zamiast powielać pobożne życzenia (a Tech Writerzy również je mają), stawiają na brutalną niemal szczerość i jasny przekaz. Taką właśnie książką rzuca w nas Mark Baker.
W sieci można natknąć się na całkiem sporo materiałów dotyczących DITA, jednak znalezienie czegoś w języku polskim jest dość trudne. Chcąc zmienić ten stan rzeczy, postanowiliśmy stworzyć dla Was niniejsze kompendium wiedzy o tym standardzie.
Nie raz zdarza się nam siedzieć godzinami i przeszukiwać bezmiar zasobów zgromadzonych treści w poszukiwaniu tej jednej, najważniejszej, która, teoretycznie, powinna pojawić się na ekranie monitora po kilku kliknięciach. Im dłużej szukamy, tym większa w nas frustracja i złość, bo przecież nasza baza czy Internet są tak dobrze zorganizowane. Jednak czy na pewno tak jest skoro nie możemy odszukać tego, co nam jest potrzebne?