<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Fri, Mar 27, 2015 at 3:46 PM, Bernd Bausch <span dir="ltr"><<a href="mailto:berndbausch@gmail.com" target="_blank">berndbausch@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">One of the points raised in the last install guide meeting was the question if separate sources should be created for the various Linux distributions or if one source should be used, as is currently the case with the DocBook-based guides. I believe that the team tended towards separate sources because it wasn't clear how conditional text of the form "if SUSE then these install instructions, else if Redhat then those instructions" could be implemented in RST.<br>
<br>
Has anybody investigated whether the built-in Sphinx extension "ifconfig" (<a href="http://sphinx-doc.org/ext/ifconfig.html" target="_blank">http://sphinx-doc.org/ext/ifconfig.html</a>) would be an adequate solution?<br></blockquote><div><br></div><div>Yes. </div><div><br></div><div>Refer to <a href="http://lists.openstack.org/pipermail/openstack-docs/2015-February/005863.html">http://lists.openstack.org/pipermail/openstack-docs/2015-February/005863.html</a> </div><div><br></div><div>For consideration is that going to RST/Sphinx is meant to simplify authoring. Conditional, especially at the phrase level, is not simplification.</div><div><br></div><div>Please do study it further though if you are interested! I could be persuaded to have one set of guides remain complicated if presented with enough information. My sense of it today is that it's not part of our primary goals going forward though.</div><div><br></div><div>Thanks,</div><div>Anne</div><div><br></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
<span><font color="#888888"><br>
Bernd Bausch<br>
<a href="mailto:berndbausch@gmail.com" target="_blank">berndbausch@gmail.com</a><br>
_______________________________________________<br>
OpenStack-docs mailing list<br>
<a href="mailto:OpenStack-docs@lists.openstack.org" target="_blank">OpenStack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
</font></span></blockquote></div><br><br clear="all"><div><br></div>-- <br><div>Anne Gentle<br><a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a></div>
</div></div>