Docserv² is a tool to publish large-scale documentation websites accommodating multiple products, product versions, and localizations. It focuses on allowing publication of DocBook/AsciiDoc content that is compatible with DAPS. However, it can also accommodate links to other sources of documents.
The Docserv² build server is written in Python/Bash/XSLT and designed to run as a daemon. Its Git repository is at https://github.com/openSUSE/docserv.
The following elements that are relevant to Docserv²:
Machines:
Git is used for versioning the sources of the content to publish.
The Docserv² build server is the core piece of the publication process. It builds documents and their associated navigation pages. After building a specific piece of documentation, it copies the documentation output to a backup directory and from there to a publication server.
The build server also provides a REST API that can be used to trigger rebuilds for documentation and check the status of those rebuilds.
The publication server (or target) is the server where documentation is ultimately hosted. There are no server-side scripts that needs to run on targets. Therefore, any computer running a compatible Web server is suitable as a target.
People:
Writers create content in the form of DocBook or AsciiDoc articles, books, and sets.
Release managers publish content by creating configuration and triggering API calls.