#75 Tech Writer wprowadza porządek, czyli po co nam structured writing

Tech Writer koduje

Treść dostarczona przez Michał Skowron i Paweł Kowaluk, Michał Skowron, and Paweł Kowaluk. Cała zawartość podcastów, w tym odcinki, grafika i opisy podcastów, jest przesyłana i udostępniana bezpośrednio przez Michał Skowron i Paweł Kowaluk, Michał Skowron, and Paweł Kowaluk lub jego partnera na platformie podcastów. Jeśli uważasz, że ktoś wykorzystuje Twoje dzieło chronione prawem autorskim bez Twojej zgody, możesz postępować zgodnie z procedurą opisaną tutaj https://pl.player.fm/legal.

2M ago 55:30

MP3•Źródło odcinka

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

77 odcinków

#Doc Developer #Technologie