Documenting with Antora, AsciiDoc and GitLab pages
Channel: Dashamir Hoxha
Date: 2024-01-04

Documentation is one of the cornerstones of building maintainable IT infrastructure. It seems like unnecessary extra work and often it is neglected, but a proper documentation allows easy maintenance, update and improvements of the IT infrastructure. It also ensures continuity, when the sysadmin staff is changed.

This workshop describes and explains the documentation system that is being used by the LUGBZ SysTeam: Antora + AsciiDoc + GitLab pages (https://docs.lugbz.org/). It follows the well-known Docs-as-code philosophy.