Re: [atomic-devel] Doc format?

[Kushal Das <mail kushaldas in>]

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