#75 Tech Writer wprowadza porządek, czyli po co nam structured writing
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-markdownSemantic Authoring Markdown (sam): https://github.com/mbakeranalecta/samSemantic Markdown: https://hackmd.io/@sparna/semantic-markdown-draft#What-is-Semantic-MarkdownMarkdoc: https://markdoc.dev/MDX: https://mdxjs.com/Lightweight DITA: https://docs.oasis-open.org/dita/LwDITA/v1.0/cnprd01/LwDITA-v1.0-cnprd01.htmlHyperText Markup Language (HTML): https://developer.mozilla.org/en-US/docs/Web/HTML
Paweł i Michał omawiają pojęcie structured writing i jego znaczenie w technicznym pisaniu dokumentacji.
Rozkłady definicji structured writingu, porównanie z single purpose function i procedurami w numerowanych listach.
Michał wyjaśnia koncepcję domen dokumentu: document domain, medium domain i subject domain.
Porównanie structured writingu z DITA oraz problemy związane z backsliding w narzędziach WYSIWYG.
Analiza Markdowna jako języka znaczników i jego ograniczenia w kontekście structured writingu, omówienie MarkDoca.
Rozmowa skupia się na MDX - cichym standardzie łączącym Markdown i XML, który pozwala na semantyczną wartość i dynamiczne elementy w dokumentacji.
Diskurs o tym, czy AI zyskuje na structured writingie. Autor podaje argumenty przeciwko tezie, że to pomaga LLMom w lepszym rozumieniu treści.
Rozdziały i streszczenia generowane automatycznie. Pełna transkrypcja nie jest publikowana — wyszukaj frazę, aby zobaczyć dopasowane fragmenty.
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-markdownSemantic Authoring Markdown (sam): https://github.com/mbakeranalecta/samSemantic Markdown: https://hackmd.io/@sparna/semantic-markdown-draft#What-is-Semantic-MarkdownMarkdoc: https://markdoc.dev/MDX: https://mdxjs.com/Lightweight DITA: https://docs.oasis-open.org/dita/LwDITA/v1.0/cnprd01/LwDITA-v1.0-cnprd01.htmlHyperText Markup Language (HTML): https://developer.mozilla.org/en-US/docs/Web/HTML