<div dir="ltr"><div>Hi,</div><div><br></div><div>I've recently noticed that files in <a href="http://clang.llvm.org/extra/clang-tidy/checks/">http://clang.llvm.org/extra/clang-tidy/checks/</a> (and the rest of clang-tools-extra sphinx documents) had last been built on July 18 (by Sphinx 1.1.3). The rest of clang docs seem to build normally (using Sphinx 1.4.5), which makes me think that the issue might have something to do with the upgrade of sphinx. I've updated it locally and the issues should be fixed now in <span style="color:rgb(0,0,0)">r279049.</span><br></div><div><br></div><div>The clang-sphinx-docs buildbot was green all this month (e.g. <a href="http://lab.llvm.org:8011/builders/clang-sphinx-docs/builds/15762">http://lab.llvm.org:8011/builders/clang-sphinx-docs/builds/15762</a>), but I don't know 1. whether it builds clang-tools-extra docs and 2. which version of Sphinx (and Pygments) it uses.</div><div><br></div><div>So the questions:</div><div>  1. Tanya, can we make the process of building docs for <a href="http://llvm.org">llvm.org</a> more transparent? In the form of a status dashboard, logs of the last build or e-mail notifications, for example.</div><div>  2. Dmitri, can you update Sphinx on the clang-sphinx-docs buildbot to the same version that is used to build docs for <a href="http://llvm.org">llvm.org</a>?</div><div>  3. Dmitri, could you include clang-tools-extra docs to the build steps on the clang-sphinx-docs buildbot?</div><div>  4. Can we provide a better coordination between documentation format and tools versions? Possible options are:</div><div>    a. Move in the direction of hermetic documentation builds. For instance, put a private copy of Sphinx to LLVM sources somewhere in llvm/utils/ and fix the documentation files when updating Sphinx.</div><div>    b. Strictly require a certain version of Sphinx when building documentation. Only works if there is a sane and reliable way to get a specific version of the package on every platform.</div><div>    c. At least, coordinate Sphinx updates on all docs buildbots and whatever is used to build docs for <a href="http://llvm.org">llvm.org</a>.</div><div><br></div><div>Thanks!</div><div><br></div><div>-- Alex</div></div>