Thank you so much, Steve, for the research! It's great to know what caused this problem so we can all avoid it in the future.<span></span><br><br>On Saturday, November 16, 2013, Steve Gordon wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
----- Original Message -----<br>
> From: "Steve Gordon" <<a href="javascript:;" onclick="_e(event, 'cvml', 'sgordon@redhat.com')">sgordon@redhat.com</a>><br>
> To: "Gauvain Pocentek" <<a href="javascript:;" onclick="_e(event, 'cvml', 'gauvain.pocentek@objectif-libre.com')">gauvain.pocentek@objectif-libre.com</a>><br>
> Cc: "openstack-docs" <<a href="javascript:;" onclick="_e(event, 'cvml', 'openstack-docs@lists.openstack.org')">openstack-docs@lists.openstack.org</a>><br>
> Sent: Saturday, November 16, 2013 5:54:12 PM<br>
> Subject: Re: [Openstack-docs] Broken MySQL chapter<br>
><br>
> ----- Original Message -----<br>
> > From: "Gauvain Pocentek" <<a href="javascript:;" onclick="_e(event, 'cvml', 'gauvain.pocentek@objectif-libre.com')">gauvain.pocentek@objectif-libre.com</a>><br>
> > To: "Anne Gentle" <<a href="javascript:;" onclick="_e(event, 'cvml', 'annegentle@justwriteclick.com')">annegentle@justwriteclick.com</a>><br>
> > Cc: "openstack-docs" <<a href="javascript:;" onclick="_e(event, 'cvml', 'openstack-docs@lists.openstack.org')">openstack-docs@lists.openstack.org</a>><br>
> > Sent: Saturday, November 16, 2013 12:42:36 AM<br>
> > Subject: Re: [Openstack-docs] Broken MySQL chapter<br>
> ><br>
> > Hey,<br>
> ><br>
> > Le 15/11/2013 22:01, Anne Gentle a écrit :<br>
> > > Any root cause we can avoid?<br>
> ><br>
> > If we were dealing with code I'd say "we lack unit tests", but for<br>
> > documentation it is probably very hard to manage (are there some tools<br>
> > out there to test documentation?).<br>
><br>
> Doing "proper" CI with full coverage that actually extracts and runs all the<br>
> instructions is difficult, but in this case I think we could pick the cause<br>
> of the issue up in validation. I've proposed an update to test.py here:<br>
><br>
> <a href="https://review.openstack.org/#/c/56790/" target="_blank">https://review.openstack.org/#/c/56790/</a><br>
><br>
> For the change in question the output would have been:<br>
><br>
> python ./tools/test.py --check-syntax<br>
> Checking syntax of xml files...<br>
> Validating install-guide/ch_basics.xml<br>
> install-guide/ch_basics.xml: {<a href="http://docbook.org/ns/docbook}itemizedlist" target="_blank">http://docbook.org/ns/docbook}itemizedlist</a> os<br>
> profiling (['opensuse', 'sles']) conflicts with os profiling of<br>
> {<a href="http://docbook.org/ns/docbook}screen" target="_blank">http://docbook.org/ns/docbook}screen</a> on line 276.<br>
> Check failed, validated 1 xml files with 1 failures.<br>
<br>
Running this against all books I found a few other instances of this problem we need to look at:<br>
<br>
Checking syntax of all xml files...<br>
install-guide/section_dashboard-install.xml: {<a href="http://docbook.org/ns/docbook}step" target="_blank">http://docbook.org/ns/docbook}step</a> os profiling (['opensuse', 'sles', 'fedora', 'centos', 'rhel']) conflicts with os profiling of {<a href="http://docbook.org/ns/docbook}screen" target="_blank">http://docbook.org/ns/docbook}screen</a> on line 177.<br>
install-guide/section_glance-install.xml: {<a href="http://docbook.org/ns/docbook}step" target="_blank">http://docbook.org/ns/docbook}step</a> os profiling (['rhel', 'centos', 'fedora', 'opensuse', 'sles', 'ubuntu']) conflicts with os profiling of {<a href="http://docbook.org/ns/docbook}para" target="_blank">http://docbook.org/ns/docbook}para</a> on line 60.<br>
install-guide/section_nova-compute.xml: {<a href="http://docbook.org/ns/docbook}step" target="_blank">http://docbook.org/ns/docbook}step</a> os profiling (['rhel', 'centos', 'fedora']) conflicts with os profiling of {<a href="http://docbook.org/ns/docbook}screen" target="_blank">http://docbook.org/ns/docbook}screen</a> on line 97.<br>
install-guide/section_heat-install.xml: {<a href="http://docbook.org/ns/docbook}procedure" target="_blank">http://docbook.org/ns/docbook}procedure</a> os profiling (['rhel', 'centos', 'fedora', 'opensuse', 'sles', 'ubuntu']) conflicts with os profiling of {<a href="http://docbook.org/ns/docbook}para" target="_blank">http://docbook.org/ns/docbook}para</a> on line 39.<br>
install-guide/section_nova-controller.xml: {<a href="http://docbook.org/ns/docbook}step" target="_blank">http://docbook.org/ns/docbook}step</a> os profiling (['rhel', 'centos', 'fedora', 'opensuse', 'sles', 'ubuntu']) conflicts with os profiling of {<a href="http://docbook.org/ns/docbook}para" target="_blank">http://docbook.org/ns/docbook}para</a> on line 61.<br>
install-guide/section_ceilometer-install.xml: {<a href="http://docbook.org/ns/docbook}step" target="_blank">http://docbook.org/ns/docbook}step</a> os profiling (['rhel', 'centos', 'fedora', 'opensuse', 'sles', 'ubuntu']) conflicts with os profiling of {<a href="http://docbook.org/ns/docbook}para" target="_blank">http://docbook.org/ns/docbook}para</a> on line 123.<br>
install-guide/section_cinder-node.xml: {<a href="http://docbook.org/ns/docbook}step" target="_blank">http://docbook.org/ns/docbook}step</a> os profiling (['centos', 'rhel', 'fedora', 'opensuse', 'sles', 'ubuntu']) conflicts with os profiling of {<a href="http://docbook.org/ns/docbook}programlisting" target="_blank">http://docbook.org/ns/docbook}programlisting</a> on line 117.<br>
install-guide/section_cinder-controller.xml: {<a href="http://docbook.org/ns/docbook}step" target="_blank">http://docbook.org/ns/docbook}step</a> os profiling (['rhel', 'centos', 'fedora', 'opensuse', 'sles', 'ubuntu']) conflicts with os profiling of {<a href="http://docbook.org/ns/docbook}para" target="_blank">http://docbook.org/ns/docbook}para</a> on line 38.<br>
Check failed, validated 717 xml files with 8 failures.<br>
<br>
For the most part they seem to be cases where the os profile of the parent lists every os *except* debian and then one of the children has os="debian".<br>
<br>
-Steve<br>
<br>
_______________________________________________<br>
Openstack-docs mailing list<br>
<a href="javascript:;" onclick="_e(event, 'cvml', 'Openstack-docs@lists.openstack.org')">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>
</blockquote><br><br>-- <br><div dir="ltr">Thank you!<div><br></div><div>Nermina Miller</div><div>Tech Writer and Editor</div></div><br>