On 25 September 2018 at 10:40, Paolo Bonzini <pbonz...@redhat.com> wrote: > However, we currently have the worst of both worlds. We have a manual > in Texinfo that almost nobody updates (except for the small parts that > are generated from .hx files in the code) and sparse documentation > written in a mix of rST, Markdown-but-not-quite, and > not-even-trying-to-be-Markdown.
One improvement I've thought about here would be having board documentation (eg "what is this board, what devices does it implement or not yet implement") be in a doc comment in the relevant source file, and then we could stitch those together into the user-facing docs. Right now the texinfo (as you say) has a really outdated list of boards and info on them. thanks -- PMM
