Details
-
Bug
-
Status: Closed
-
Major
-
Resolution: Fixed
-
0.8.0
-
None
Description
The schema_txt.py program [1] generates schema.adoc, which is included in the Dispatch Router book [2]. However, there is an issue with the asciidoc that's generated: the attributes for each configuration and management entity are generated as asciidoc def lists. This is perfectly fine, but some of the attributes don't have descriptions. When one of these "empty" def list entries immediately precedes a new section, that section is not styled properly in the output. To see examples of this, in the Dispatch Router book, search for the following strings:
- === vhost
- === vhostStats
- == Management Operations
To fix this issue, in qdrouter.json, a "description": "<value>" name-value pair should be added to each attribute that's missing one. If that's not feasible, an alternative would be to update schema_doc.py to properly handle any attribute that doesn't have a description (it looks like lines 70-71 should handle this, but my python's not up to snuff enough to figure out why it isn't).
[1] - https://github.com/apache/qpid-dispatch/blob/master/doc/book/schema_txt.py
[2] - https://qpid.apache.org/releases/qpid-dispatch-0.8.0/book/book.html#_configuration_entities