<div dir="ltr"><div><div class="gmail_extra"><div class="gmail_quote">On Thu, Sep 13, 2018 at 1:09 AM, Doug Hellmann <span dir="ltr"><<a href="mailto:doug@doughellmann.com" target="_blank">doug@doughellmann.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
The longer version is that we want to continue to use the existing<br>
tox environment in each project as the basis for the job, since<br>
that allows teams to control the version of python used, the<br>
dependencies installed, and add custom steps to their build (such<br>
as for pre-processing the documentation). So, the new or updated<br>
job will start by running "tox -e docs" as it does today. Then it<br>
will run Sphinx again with the instructions to build PDF output,<br>
and copy the results into the directory that the publish job will<br>
use to sync to the web server. And then it will run the scripts to<br>
build translated versions of the documentation as HTML, and copy<br>
the results into place for publishing.<br></blockquote></div></div><div class="gmail_extra"><br></div><div class="gmail_extra">Just a question out of curiosity. You mention that we still want to use the docs environment because it allows fine grained control over how the documentation is created. However, as I understand, the PDF output will happen in a more standardized way and outside of that fine grained control, right? That couldn't lead to differences in both documentations? Do we have to even worry about that? <br></div><div class="gmail_extra"><br></div></div></div>