Documentation as Code

Fórumok

Ti milyen eszközt használtok dokumentáció generálására markdown fájlokból?

Jelenleg kisebb dolgokra az https://www.mkdocs.org/ vált be, master-re merge-nél ki is generálja a Github vagy Gitlab page-et.

Néztem még az https://asciidoc.org/ -ot is. Fontos lenne, hogy lehetőség szerint ne legyen Enterprise űrhajó, gyorsan el tudják sajátítani a kollégák.

Hozzászólások

Asciidoctor (bár mintha megeledt volna a sima is) szerintem jó balance a lehet írni könnyen -- van benne elég formázás