These pages contain source files that reside in the server repository.
They are converted to HTML using mandoc
:
# from rabbitmq/rabbitmq-server
gmake docs
ls docs/*.html
Since these files are generated, it is important to keep them in sync with the source. Accepting community contributions — which will always come as website pull requests — is fine but the person who merges them is responsible for backporting all changes to the source pages.
When a new man page is added, its contents as generated by mandoc
have to
be copied into this directory. A new wrapper DocBook page must be added
to the parent (site
) directory, see site/rabbitmq-diagnostics.8.xml
for example.