W komunikacji technicznej (i nie tylko) występuje zjawisko ustrukturyzowanego tworzenia treści, czyli "structured writing" albo jak kto woli "structured authoring". Cała idea sprowadza się do stworzenia zasad, które są potem stosowane w trakcie pisania. Poprzez narzucenie takich ściśle określonych reguł jesteśmy w stanie dostarczać treść, która jest lepszej jakości i którą nasi odbiorcy są w stanie łatwiej i szybciej konsumować.
"Structured writing" to złożone zagadnienie. Mnogość zalet przeplata się tutaj z równie dużą liczbą wyzwań.
Rozmawiamy o tym czym jest ustrukturyzowane tworzenie treści, co nam daje, w czym nam pomaga a w czym przeszkadza oraz jakich standardów i narzędzi możemy użyć do jego wdrożenia w organizacji.
Dźwięki wykorzystane w audycji pochodzą z kolekcji "107 Free Retro Game Sounds" dostępnej na stronie https://dominik-braun.net, udostępnianej na podstawie licencji Creative Commons license CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/).
Informacje dodatkowe:
- "Structured writing", Wikipedia: https://en.wikipedia.org/wiki/Structured_writing
- "Structured authoring in technical documentation: an overview", Author-it blog: https://www.author-it.com/blog/structured-authoring-in-technical-documentation/
- "What is Structured Writing?", Mark Baker: https://techwhirl.com/what-is-structured-writing/
- "Topic-based authoring", Wikipedia: https://en.wikipedia.org/wiki/Topic-based_authoring
- "Darwin Information Typing Architecture", Wikipedia (DITA): https://pl.wikipedia.org/wiki/Darwin_Information_Typing_Architecture
- "Markdown", Wikipedia: https://pl.wikipedia.org/wiki/Markdown
- "The path to structured content with Markdown", Niklas Begley: https://www.doctave.com/blog/path-to-structured-markdown
- Semantic Authoring Markdown (sam): https://github.com/mbakeranalecta/sam
- Semantic Markdown: https://hackmd.io/@sparna/semantic-markdown-draft#What-is-Semantic-Markdown
- Markdoc: https://markdoc.dev/
- MDX: https://mdxjs.com/
- Lightweight DITA: https://docs.oasis-open.org/dita/LwDITA/v1.0/cnprd01/LwDITA-v1.0-cnprd01.html
- HyperText Markup Language (HTML): https://developer.mozilla.org/en-US/docs/Web/HTML