<div dir="ltr"><div><div><div>Hi,<br></div>I found out that this discussion was pursued only in the psc mailing list (<a href="http://lists.osgeo.org/pipermail/qgis-psc/2015-December/003781.html">http://lists.osgeo.org/pipermail/qgis-psc/2015-December/003781.html</a>) though it also concers documenters.<br></div>Please, keep sending messages to both lists.<br></div>Thanks.<br></div><div class="gmail_extra"><br><div class="gmail_quote">2015-12-28 17:09 GMT+01:00 Richard Duivenvoorde <span dir="ltr"><<a href="mailto:richard@duif.net" target="_blank">richard@duif.net</a>></span>:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">On 27-12-15 22:35, Tim Sutton wrote:<br>
<br>
> Just bouncing the idea around: If we follow all this logic surely<br>
> it is better to switch to Markdown which is a lot more mainstream<br>
> and simple to pick up and use because of its cleaner syntax? I<br>
> guess with Markdown we lose the advantage of RST that  we do have:<br>
> richer syntax cross referencing, multi-chapter support, translation<br>
> support etc. ? Which of these are we still planning to keep?<br>
<br>
</span>I'm not against using Markdown, but I'm not aware of any tooling<br>
around Markdown, for building and/or i18n stuff.<br>
<br>
So sphinx not only builds, but also helps us with:<br>
- doing i18n<br>
- templates for pages<br>
- references and indexes<br>
- pdf generatation<br>
<br>
I think at least the first 3 are essential for our documentation<br>
process, but others please let us know if we are wrong....<br>
Happy to switch, because some constructs (mainly the inline images)<br>
are just plain easier in Markdown, but after some googling, I think<br>
markdown is just not good enough for our usecase (i18n and indexes-wise)<br>
<br>
Some links:<br>
<br>
<a href="http://stackoverflow.com/questions/2471804/using-sphinx-with-markdown-in
stead-of-rst" rel="noreferrer" target="_blank">http://stackoverflow.com/questions/2471804/using-sphinx-with-markdown-in<br>
stead-of-rst</a><br>
<br>
<a href="http://strapdownjs.com/" rel="noreferrer" target="_blank">http://strapdownjs.com/</a><br>
<br>
Regards,<br>
<br>
Richard<br>
<div class="HOEnZb"><div class="h5">_______________________________________________<br>
Qgis-community-team mailing list for organizing community resources such as documentation, translation etc..<br>
<a href="mailto:Qgis-community-team@lists.osgeo.org">Qgis-community-team@lists.osgeo.org</a><br>
<a href="http://lists.osgeo.org/mailman/listinfo/qgis-community-team" rel="noreferrer" target="_blank">http://lists.osgeo.org/mailman/listinfo/qgis-community-team</a></div></div></blockquote></div><br></div>