<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Sat, May 7, 2016 at 4:15 AM, Thomas Goirand <span dir="ltr"><<a href="mailto:zigo@debian.org" target="_blank">zigo@debian.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex">Hi,<br>
<br>
During the Austin summit, I could discuss with Lana about what could be<br>
done for the Debian support in the install-guide.<br>
<br>
Currently, there's these facts:<br>
- The Debconf support adds lots of conditionals which aren't easy to<br>
support (ie: it makes the individual foo-install.rst more complicated).<br>
- Some people would prefer to document the non-interactive mode.<br>
- Some people (like me) would still prefer to keep supporting using<br>
Debconf during the installation.<br>
<br>
As a consequence, we believe the most easy way forward is as follow:<br>
- Keep Debian support directly in the install-guide.<br>
- Remove conditionals for Debian using Debconf in the foo-install.rst<br>
files, and document there the DEBIAN_FRONTEND=noninteractive mode.<br>
- Push Debconf support in separate foo-debconf-install.rst files, and<br>
use them to generate the install-guide instead of the normal files.<br>
<br>
This means that effectively, we'd have 2 install-guide for Debian, and<br>
not one anymore. Though the non-interactive one would be very close from<br>
the Ubuntu one, and wouldn't add much work.<br>
<br>
The chapter explaining how Debconf works will have to be written in 2<br>
versions, one explaining generalities about Debconf, for the<br>
Debconf-supporting install-guide, and one explaining how to switch to<br>
the non-interactive mode (ie: using DEBIAN_FRONTEND= or doing<br>
dpkg-reconfigure debconf).<br>
<br>
I hope this solution will satisfy everyone.<br>
<br>
Going forward, to make this happen, I would need that the Debian install<br>
guide gets published again. I am currently not sure how to make this<br>
happen (ie: what kind of patch is needed?). I have made this patch:<br>
<a href="https://review.openstack.org/313854" rel="noreferrer" target="_blank">https://review.openstack.org/313854</a> but is this enough to get the guide<br>
in <a href="http://docs.openstack.org" rel="noreferrer" target="_blank">docs.openstack.org</a>?</blockquote><div><br></div><div>In addition to the script change, you need to look at the build jobs in project-config to see if the correct files will be copied. From <a href="http://docs.openstack.org/contributor-guide/docs-builds.html#build-jobs">http://docs.openstack.org/contributor-guide/docs-builds.html#build-jobs</a></div><div><br></div><div><p style="margin:0px 0px 10px;color:rgb(51,51,51);font-family:'Open Sans',Helvetica,Arial,sans-serif;font-size:14px;line-height:20px">The build jobs for documentation are stored in the <a class="" href="http://git.openstack.org/cgit/openstack-infra/project-config" style="color:rgb(48,115,156);background:0px 0px">http://git.openstack.org/cgit/openstack-infra/project-config</a> repository. The <tt class="" style="">zuul/layout.yaml</tt> file and the <tt class="" style="">jenkins/jobs/manual-jobs.yaml</tt> or <tt class="" style="">jenkins/jobs/api-jobs.yaml</tt> file contain the Jenkins build jobs that build to the <a href="http://docs.openstack.org">docs.openstack.org</a> and <a href="http://developer.openstack.org">developer.openstack.org</a> sites, copying built files via FTP.</p><p style="margin:0px 0px 10px;color:rgb(51,51,51);font-family:'Open Sans',Helvetica,Arial,sans-serif;font-size:14px;line-height:20px">The release specific books are built for the currently supported branches (current and previous releases), development happens on the master branch. The continuously released books are only built on the master branch.</p></div><div><br></div><div>Then also patch the www/mitaka/index.html file in openstack-manuals to link to the built html. <a href="https://github.com/openstack/openstack-manuals/blob/master/www/mitaka/index.html">https://github.com/openstack/openstack-manuals/blob/master/www/mitaka/index.html</a> There's also a draft-index html file that's built locally that you'll want to update to point to debian.</div><div><br></div><div>When you work on the project-config configurations, ensure you're publishing from the stable/mitaka branch, since you'll need to back port to there I believe.</div><div><br></div><div>Basic steps:</div><div>- change Sphinx build script in openstack-manuals like 313854</div><div>- make sure project-config files are building what you think</div><div>- make sure the branches are building what you think</div><div>- change www/mitaka/index.html in openstack-manuals to link to built guide</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex"> Also, what would be needed to get a guide with<br>
debiandebconf tag?<br></blockquote><div><br></div><div>More scripting in openstack-manuals for the conditional tag-based Sphinx build, and then check the build jobs from <a href="http://docs.openstack.org/contributor-guide/docs-builds.html#build-jobs">http://docs.openstack.org/contributor-guide/docs-builds.html#build-jobs</a>. </div><div><br></div><div>Thanks for asking good questions -</div><div>Anne</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex">
<br>
Thoughts anyone?<br>
<br>
Cheers,<br>
<br>
Thomas Goirand (zigo)<br>
<br>
_______________________________________________<br>
OpenStack-docs mailing list<br>
<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
</blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div>Anne Gentle</div><div><a href="http://www.justwriteclick.com" style="font-size:12.8px" target="_blank">www.justwriteclick.com</a><br></div></div></div></div></div>
</div></div>