<div dir="ltr"><div><div><div>I can explain further.<br></div>This is a low hanging fruit, to produce RST (which is like Markdown but better) from input files and feed it to a production grade documentation tool (Sphinx is what used to build docs for Python and million smaller projects <a href="http://www.sphinx-doc.org/en/stable/examples.html">http://www.sphinx-doc.org/en/stable/examples.html</a> )<br><br></div>Using this RST it is able to produce static nice looking HTML with search bar, cross references (to functions, to types, to chapters/sections etc), code snippets, links, URL references and images, all that sort of thing based only on RST input. Each page also contains link to Github page source (does this ring a bell?) Along with HTML a PDF version can be produced.<br><br></div><div>This seems to cover many of Kenneth Lundin's concerns and requirements to a better documentation.<br></div><div><br></div>Again, this is a low hanging fruit. Just produce RST from Edoc and see if the team and community like it. I could possibly try and produce a POC.<br><div><div><div><div><br><div class="gmail_quote"><div dir="ltr">tis 27 sep. 2016 kl 14:12 skrev Dmytro Lytovchenko <<a href="mailto:dmytro.lytovchenko@gmail.com">dmytro.lytovchenko@gmail.com</a>>:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><p dir="ltr">Just a thought.<br>
Here in the discussion, has anyone considered converting existing docs to the input format of some popular documenting tool? I can imagine that producing Restructured Text for Sphinx is doable, output is beautiful, static html that can be themed and no problems with code snippets either.</p>
</blockquote></div></div></div></div></div></div>