On 11/03/16, Nick Coghlan wrote: <snipped> > Where Sphinx/reStructuredText is most powerful is in documenting > software APIs, especially for low overhead documentation that is > autogenerated from the Python docstrings, but there unfortunately > aren't any DocbookXML converters that are aware of the semantically > significant Sphinx roles - the extant converters all operate at the > reStructuredText presentation layer, and hence lose a lot of > information :( I thought the internal tools moved away from Docbook, but I may be wrong. Sphinx is always the personal choice for documentation needs. It has very low entry barrier for new contributors.
Kushal -- Fedora Cloud Engineer CPython Core Developer https://kushaldas.in https://dgplug.org