<p dir="ltr">I've personally never written RST, but if its similar to markdown, maintaining docs should be pretty simple.</p>
<br><div class="gmail_quote">On Tue, Apr 14, 2015, 8:00 PM Pete Travis <<a href="mailto:lists@petetravis.com">lists@petetravis.com</a>> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi there,<br>
<br>
I'm working on a project[0] to build a documentation website using<br>
buildbot. We have plenty of publican books for me to play with, but I'd<br>
also like to enable other formats. ReStructuredText[1] seems like a<br>
good first choice, as it's easy to learn and use (just squint and<br>
pretend it's markdown, if you aren't familiar), and there are processors<br>
for it at hand.<br>
<br>
Anerist is centered around consuming git repositories. Ultimately, I'd<br>
like the site to offer the both user and contributor facing<br>
documentation. I also need a repo full of RST content to bang out<br>
implementation details. infra-docs.git seems ideally positioned to help<br>
out here, and any time invested would carry forward to the end product.<br>
Each article would need some kind of header[2] to work at scale, though.<br>
<br>
So, what does the infrastructure team think about writing in RST? If<br>
I'm willing to convert everything over, are you willing to sustain it?<br>
<br>
--Pete<br>
<br>
<br>
[0] slowly, anyway... <a href="https://github.com/immanetize/anerist" target="_blank">https://github.com/immanetize/anerist</a><br>
[1] <a href="http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html" target="_blank">http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html</a><br>
[1b] more digestable: <a href="http://www.getnikola.com/quickstart.html" target="_blank">http://www.getnikola.com/quickstart.html</a><br>
[2] Probably something like<br>
<a href="https://lists.fedoraproject.org/pipermail/docs/2015-March/016101.html" target="_blank">https://lists.fedoraproject.org/pipermail/docs/2015-March/016101.html</a>,<br>
discussion encouraged.<br>
<br>
<br>
_______________________________________________<br>
infrastructure mailing list<br>
<a href="mailto:infrastructure@lists.fedoraproject.org" target="_blank">infrastructure@lists.fedoraproject.org</a><br>
<a href="https://admin.fedoraproject.org/mailman/listinfo/infrastructure" target="_blank">https://admin.fedoraproject.org/mailman/listinfo/infrastructure</a></blockquote></div>