#39 DITA as code, czyli klasyczny standard w nowoczesnym wydaniu

Published: Feb. 14, 2022, 6:25 a.m.

b'

DITA w modelu "docs as code"? Kto to widzia\\u0142? Czy to si\\u0119 da zrobi\\u0107 i czy to w og\\xf3le ma sens? Po snuciu teorii na ten temat, przyszed\\u0142 czas na konkretne dzia\\u0142ania.

\\n

Rozmawiamy o tym co do tej pory uda\\u0142o nam si\\u0119 zrobi\\u0107, \\u017ceby w naszej organizacji wdro\\u017cy\\u0107 "DITA as code". M\\xf3wimy o narz\\u0119dziach, przyk\\u0142adowym procesie robienia zmian w dokumentacji, napotkanych trudno\\u015bciach i kolejnych krokach.

\\n

Je\\u015bli "DITA z gita" jest bliska Waszemu sercu to zapraszamy do ods\\u0142uchu.

\\n

D\\u017awi\\u0119ki wykorzystane w audycji pochodz\\u0105 z kolekcji "107 Free Retro Game Sounds" dost\\u0119pnej na stronie https://dominik-braun.net, udost\\u0119pnianej na podstawie licencji Creative Commons license CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/).

\\n

Informacje dodatkowe:

\\n
    \\n
  • "#16 DITA z Gita", Tech Writer koduje: https://techwriterkoduje.pl/blog/2020/04/22/dita-z-gita
  • \\n
  • "#8 DITA OT - static site generator dla wtajemniczonych", Tech Writer koduje: https://techwriterkoduje.pl/blog/2019/09/28/dita-ot
  • \\n
  • Standard DITA (Darwin Information Typing Architecture): https://en.wikipedia.org/wiki/Darwin_Information_Typing_Architecture
  • \\n
  • Component Content Management System (CCMS): https://en.m.wikipedia.org/wiki/Component_content_management_system
  • \\n
  • Git: https://git-scm.com/
  • \\n
  • "Docs as code", Write the Docs: https://www.writethedocs.org/guide/docs-as-code/
  • \\n
  • Bitbucket: https://bitbucket.org/
  • \\n
  • Git submodules: https://www.atlassian.com/git/tutorials/git-submodule
  • \\n
  • Bitbucket pull requests: https://www.atlassian.com/git/tutorials/making-a-pull-request
  • \\n
  • Oxygen XML: https://www.oxygenxml.com/#bidx-xml-author
  • \\n
  • "Krytyczna podatno\\u015b\\u0107 w bibliotece Apache Log4j": https://cert.pl/posts/2021/12/krytyczna-podatnosc-w-bibliotece-apache-log4j/
  • \\n
  • Sourcetree: https://www.sourcetreeapp.com/
  • \\n
  • DITA Open Toolkit (DITA OT): https://www.dita-ot.org/
  • \\n
  • Docker: https://www.docker.com/
  • \\n
  • Amazon Simple Storage Service (S3): https://aws.amazon.com/s3/
  • \\n
  • TeamCity: https://www.jetbrains.com/teamcity
  • \\n
  • Schematron: https://www.schematron.com/
  • \\n
  • "Content Reuse": https://paligo.net/docs/en/content-reuse.html
  • \\n
  • Git hooks: https://git-scm.com/book/en/v2/Customizing-Git-Git-Hooks
  • \\n
  • "Readability \\u2013 what is it and how do I improve it?", Pawe\\u0142 Kowaluk (soap! 2018): https://www.youtube.com/watch?v=LzrHrIOHhz8
  • \\n
'