Pisanie strukturalne: Retoryka i proces

Opinie czytelników

Książka ta zagłębia się w retoryczną konstrukcję języków znaczników i sposób, w jaki można je ustrukturyzować w celu lepszej komunikacji z różnymi odbiorcami. Chociaż oferuje solidny przegląd zaawansowanych języków znaczników, takich jak DITA i OWL, opiera się w dużej mierze na historii znaczników, zamiast skupiać się na praktycznych metodach organizacji. Autor podkreśla znaczenie oczekiwań odbiorców w określaniu tego, co jest uważane za zorganizowaną treść.

⬤ Kompleksowy przegląd zaawansowanych języków znaczników
⬤ cenne spostrzeżenia na temat retorycznych aspektów organizacji treści
⬤ omawia znaczenie odbiorców i oczekiwań
⬤ wprowadza metajęzyk znaczników.

⬤ Ograniczone praktyczne porady dotyczące partycjonowania i organizowania informacji
⬤ nadmierne skupienie się na historii języków znaczników
⬤ może nie zaspokoić potrzeb osób poszukujących bardziej praktycznych wskazówek.

(na podstawie 1 opinii czytelników)

Oryginalny tytuł:

Structured Writing: Rhetoric and Process

Zawartość książki:

Pisanie strukturalne nigdy nie było ważniejsze ani bardziej zagmatwane. Łatwo jest zgubić się w morzu akronimów i modnych słów: semantyka, XML, metadane, DITA, struktura, DocBook, hipertekst, Markdown, tematy, XSLT, ponowne użycie, LaTeX, silosy, HTML, ad infinitum. Structured Writing przebija się przez hałas, wyjaśniając, czym jest pisanie strukturalne i jak można wykorzystać różne struktury do osiągnięcia różnych celów. Koncentruje się na tym, jak można podzielić i zarządzać złożonością tworzenia i dostarczania treści, aby zapewnić skuteczną retorykę i wydajne procesy.

Wprowadzenie: definiuje pisanie strukturalne, związek między retoryką a procesem oraz znaczenie prawidłowego podziału złożoności.

Domeny ustrukturyzowanego pisania: wprowadza cztery domeny ustrukturyzowanego pisania: media, dokument, temat i zarządzanie oraz pokazuje, w jaki sposób zrozumienie tych domen może pomóc w tworzeniu struktur, które wspierają pisanie wysokiej jakości.

Proces, retoryka i struktura: opisuje, w jaki sposób struktura wspiera zarówno procesy, jak i retorykę. zagłębia się również w architekturę informacji i rolę pisarzy w tworzeniu treści spełniających potrzeby organizacji.

Algorytmy: analizuje główne algorytmy pisania strukturalnego, w tym pojedyncze pozyskiwanie, ponowne wykorzystanie, łączenie, aktywną zawartość, generowaną zawartość i publikowanie.

Struktury: dogłębnie analizuje struktury, w tym bloki, szerokie struktury i struktury komponowalne. Przygląda się także metadanym, zarządzaniu terminologią i zgodności.

Języki: przegląd języków używanych obecnie do pisania strukturalnego, od lekkich języków, takich jak Markdown i reStructuredd104, po ciężkie języki, takie jak DITA i DocBook. Następnie analizuje rozszerzenia i ograniczenia języków.

Zarządzanie: analizuje systemy zarządzania treścią i bada, w jaki sposób wspierać współpracę, unikać powielania i kontrolować zawartość.

Projektowanie: analizuje, jak zidentyfikować złożoność i odpowiednio ją podzielić podczas projektowania systemu, a następnie analizuje, jak wybrać procesy i narzędzia wymagane do obsługi potrzeb organizacji w zakresie treści.