Using Sphinx and rst for this is a great idea. I've used the MongoDB docs as a template for this type of initiative in the past (<a href="https://docs.mongodb.com">https://docs.mongodb.com</a>). All their source and build instructions are on GitHub if anyone's curious (<a href="https://github.com/mongodb/docs">https://github.com/mongodb/docs</a>).<div><br><div class="gmail_quote"><div dir="ltr">On Tue, Aug 7, 2018, 4:29 PM Matan Bareket, <<a href="mailto:mataniko@gmail.com">mataniko@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div>Team,</div><div><br></div><div>I want to try and reignite our documentation effort which will eventually consolidate all of the disparate docs we have (doxygen, site pages, quickstart, wiki, readme) into one central location.</div><div><br></div><div>In order to do so, i'd like to do the following:</div><div><ol><li>Create a new repo called scummvm-docs</li><li>Convert existing docs into reStructredText - Initial pass won't make much sense but it will be a good place to work off.</li><li>Eliminate redundant information - For example the FAQ on the website. The wiki will be focused on more developer related items.<br></li><li>Use readthedocs to host & manage docs</li></ol><div>A few notes: <a href="https://readthedocs.org/" target="_blank">https://readthedocs.org/</a> is a free service that takes care of the headaches of managing by automatically synchronizing with the docs repo. It also uses Sphinx to create the documentation, it also supports multiple languages so we can hook it up to weblate for translators to work off.</div><div><br></div><div>There are a few doxygen to sphinx parsers, but it's more of a phase 2.</div><div><br></div><div>Hopefully getting everything we have now into one central location that can be easily updated via git will encourage active work on our docs.</div><div><br></div><div>One caveat to readthedocs is that they place a single ethical ad on the sidebar. We can potentially host everything ourselves if it's a big issue.</div><div><br></div><div>Some sample sites on readthedocs:</div><div><a href="https://docs.phpmyadmin.net/en/latest/" target="_blank">https://docs.phpmyadmin.net/en/latest/</a></div><div><a href="http://docs.godotengine.org/en/3.0/" target="_blank">http://docs.godotengine.org/en/3.0/</a><br></div><div><br></div><div><br></div></div></div>
_______________________________________________<br>
Scummvm-devel mailing list<br>
<a href="mailto:Scummvm-devel@lists.scummvm.org" target="_blank">Scummvm-devel@lists.scummvm.org</a><br>
<a href="http://lists.scummvm.org/listinfo/scummvm-devel" rel="noreferrer" target="_blank">http://lists.scummvm.org/listinfo/scummvm-devel</a><br>
</blockquote></div></div>