<div dir="ltr">Hi,<div><br></div><div>If we are to be able to provide an API to locate and extract documentation for code constructs, what would be a good format to return it in? The source can be code comments or external files, which means that there will be multiple possible source formats (edoc, xml, asciidoc, rst, markdown, etc). </div><div><br></div><div>I can see the following alternatives:</div><div>* raw: textual data as in the source, the clients have to parse and interpret it</div><div>* display: textual data that can be rendered (basically, HTML)</div><div>* structured: some data structure that unifies the different sources; some kind of plug-ins providing parser support are needed.</div><div><br></div><div>The 'raw' solution will be needed by the other two to retrieve the doc sources, but are the others useful to have in the library? I would like to be able to provide the 'structured' format.</div><div><br></div><div>This is the kind of API I am looking at: <a href="https://gist.github.com/vladdu/aa571a548cecfeb85b84c65378429bf0">https://gist.github.com/vladdu/aa571a548cecfeb85b84c65378429bf0</a> (thanks Joe for pointing me in this direction!). There should also be a way to configure the location of the external docs.</div><div><br></div><div>best regards,<br></div><div>Vlad</div><div><br></div></div>