#39 DITA as code, czyli klasyczny standard w nowoczesnym wydaniu
Manage episode 320341629 series 2508014
DITA w modelu "docs as code"? Kto to widział? Czy to się da zrobić i czy to w ogóle ma sens? Po snuciu teorii na ten temat, przyszedł czas na konkretne działania.
Rozmawiamy o tym co do tej pory udało nam się zrobić, żeby w naszej organizacji wdrożyć "DITA as code". Mówimy o narzędziach, przykładowym procesie robienia zmian w dokumentacji, napotkanych trudnościach i kolejnych krokach.
Jeśli "DITA z gita" jest bliska Waszemu sercu to zapraszamy do odsłuchu.
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:
- "#16 DITA z Gita", Tech Writer koduje: https://techwriterkoduje.pl/blog/2020/04/22/dita-z-gita
- "#8 DITA OT - static site generator dla wtajemniczonych", Tech Writer koduje: https://techwriterkoduje.pl/blog/2019/09/28/dita-ot
- Standard DITA (Darwin Information Typing Architecture): https://en.wikipedia.org/wiki/Darwin_Information_Typing_Architecture
- Component Content Management System (CCMS): https://en.m.wikipedia.org/wiki/Component_content_management_system
- Git: https://git-scm.com/
- "Docs as code", Write the Docs: https://www.writethedocs.org/guide/docs-as-code/
- Bitbucket: https://bitbucket.org/
- Git submodules: https://www.atlassian.com/git/tutorials/git-submodule
- Bitbucket pull requests: https://www.atlassian.com/git/tutorials/making-a-pull-request
- Oxygen XML: https://www.oxygenxml.com/#bidx-xml-author
- "Krytyczna podatność w bibliotece Apache Log4j": https://cert.pl/posts/2021/12/krytyczna-podatnosc-w-bibliotece-apache-log4j/
- Sourcetree: https://www.sourcetreeapp.com/
- DITA Open Toolkit (DITA OT): https://www.dita-ot.org/
- Docker: https://www.docker.com/
- Amazon Simple Storage Service (S3): https://aws.amazon.com/s3/
- TeamCity: https://www.jetbrains.com/teamcity
- Schematron: https://www.schematron.com/
- "Content Reuse": https://paligo.net/docs/en/content-reuse.html
- Git hooks: https://git-scm.com/book/en/v2/Customizing-Git-Git-Hooks
- "Readability – what is it and how do I improve it?", Paweł Kowaluk (soap! 2018): https://www.youtube.com/watch?v=LzrHrIOHhz8
77 odcinków