Mentionsy Mentionsy
Tech Writer Koduje
Tech Writer Koduje

#53 Tech Writer robi ContentOps, czyli jak holistycznie podejść do dokumentacji

24.04.2023 ·1 godz 0 min · 10 rozdziałów

Dokumentacja nie powstaje w próżni, tylko jako część większego procesu tworzenia oprogramowania lub innego produktu. Dlatego cały cykl tworzenia dokumentacji to wielkie nieskończone koło, w którym biorą udział zespoły projektowe, produktowe, testerskie i dokumentacyjne. I tutaj na scenę wchodzi ContentOps!Tak jak DevOps, ContentOps to sposób na ciągłe dostarczanie (continuous delivery) i ciągłe usprawnianie (continuous improvement) dokumentacji. W tym odcinku rozmawiamy o tym jakie są kluczowe elementy tego cyklu, jakie role biorą w nim udział i jaki to ma wpływ na poszczególnych uczestników. Jeżeli interesuje Cię strategia tworzenia treści, architektura informacji, proces pisania i narzędzia, to na pewno znajdziesz tu coś dla siebie.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: Konferencja soap!: https://soapconf.com/ "#3 SVG - przenieś grafikę w dokumentacji na wyższy poziom", Tech Writer koduje: https://techwriterkoduje.pl/blog/2019/6/14/3 "#27 Tech Writer szkoli się z Pythona", Tech Writer koduje: https://techwriterkoduje.pl/blog/2021/2/17/27 "#42 Konferencja soap! 2022 - podsumowanie", Tech Writer koduje: https://techwriterkoduje.pl/blog/2022/6/14/42 "What is DevOps?", Amazon: https://aws.amazon.com/devops/what-is-devops/ "What is ContentOps", Heretto: https://heretto.com/blog/what-is-contentops/ "Understanding content operations - Definitions and resources", GatherContent: https://gathercontent.com/blog/understanding-contentops-definitions-and-resources "Information architecture", Wikipedia: https://en.wikipedia.org/wiki/Information_architecture "Content strategy", Wikipedia: https://en.wikipedia.org/wiki/Content_strategy "#52 Od przybytku głowa też boli, czyli Tech Writer próbuje utrzymać dokumentację w ryzach", Tech Writer koduje: https://techwriterkoduje.pl/blog/2023/4/11/52 "Docs as Code", Write the Docs: https://www.writethedocs.org/guide/docs-as-code/ "Darwin Information Typing Architecture (DITA)", Wikipedia: https://en.wikipedia.org/wiki/Darwin_Information_Typing_Architecture "Component Content Management System (CCMS)", Wikipedia: https://en.m.wikipedia.org/wiki/Component_content_management_system "About pull requests", GitHub : https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests

Introdukcja i powody poruszania tematu

Paweł Kowaluk, ekspert od ContentOps, rozmawia z Michałem o znaczeniu ContentOps i powodach poruszania tego tematu.

1:51
Opis konferencji SOAP i jej tematów

Paweł podziela się szczegółami dotyczące konferencji SOAP, w tym jej terminach i speakerach.

3:17
Definicja ContentOps i porównanie z DevOps

Paweł definiuje ContentOps jako kontynuacyjne aktualizowanie treści, podkreślając różnice z DevOps.

4:58
Zintegrowane podejście do ContentOps

Paweł omawia z Michałem zintegrowane podejście do ContentOps, w tym kontynuacyjne dostarczanie treści i analitykę.

4:57
Formatowanie PDF w ContentOps

Rozmowa o zastosowaniu PDF w ContentOps, jego zaletach i wadach, oraz rolę użytkownika w tym procesie.

5:11
Role ludzi w ContentOps

Paweł opisuje role ludzi w ContentOps, w tym Content Strategist i Information Architect, oraz ich znaczenie.

11:00
Rola Tech Writera w ContentOps

Rozmowa skupia się na roli Tech Writera w systemie ContentOps, jego elastyczności i potrzebie współpracy z innymi rolami.

8:48
Współpraca i inwestycje w ludzi

Diskussja na temat potrzeby współpracy między różnymi rolami oraz znaczenia inwestowania w ludzi w ContentOps.

15:44
Proces ContentOps

Opisano proces ContentOps, w tym tworzenie treści, testowanie, publikowanie i zarządzanie feedbackem.

2:48
Koordynacja feedbacku

Opisano sposób zarządzania feedbackem wewnątrz zespołu techwriterów i współpracy z innymi zespołami.

1:13

Rozdziały i streszczenia generowane automatycznie. Pełna transkrypcja nie jest publikowana — wyszukaj frazę, aby zobaczyć dopasowane fragmenty.