[Git][reproducible-builds/reproducible-website][master] 2023-07: improve sphinx determinism

[Vagrant Cascadian (@vagrant)]

Vagrant Cascadian pushed to branch master at Reproducible Builds / reproducible-website


Commits:
d69e2fe3 by David A. Wheeler at 2023-08-02T11:25:44-07:00
2023-07: improve sphinx determinism

Signed-off-by: Vagrant Cascadian <vagrant at reproducible-builds.org>

- - - - -


1 changed file:

- _reports/2023-07.md


Changes:

=====================================
_reports/2023-07.md
=====================================
@@ -78,6 +78,12 @@ Bernhard M. Wiedemann published another [monthly report about reproducibility wi
 
 <br>
 
+The [Sphinx](https://github.com/sphinx-doc/sphinx) documentation tool recently [accepted a change to improve deterministic
+reproducibility of documentation](https://github.com/sphinx-doc/sphinx/pull/11312). It's internal util.inspect.object_description
+attempts to sort collections, but this can fail. The change handles the failure case by using string-based object descriptions as a
+fallback deterministic sort ordering, as well as adding recursive object-description calls for list and tuple datatypes. As a result,
+documentation generated by Sphinx will be more likely to be automatically reproducible.
+
 Lastly in news, *kpcyrd* posted to our [mailing list](https://lists.reproducible-builds.org/pipermail/rb-general) announcing a new "[`repro-env`](https://github.com/kpcyrd/repro-env)" tool:
 
 > My initial interest in reproducible builds was "how do I distribute pre-compiled binaries on [GitHub](https://github.com) without people raising security concerns about them". I've cycled back to this original problem about 5 years later and built a tool that is meant to address this. [[…](https://lists.reproducible-builds.org/pipermail/rb-general/2023-July/003026.html)]



View it on GitLab: https://salsa.debian.org/reproducible-builds/reproducible-website/-/commit/d69e2fe36f140349a01a7819bfdcf658c168fc98

-- 
View it on GitLab: https://salsa.debian.org/reproducible-builds/reproducible-website/-/commit/d69e2fe36f140349a01a7819bfdcf658c168fc98
You're receiving this email because of your account on salsa.debian.org.


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.reproducible-builds.org/pipermail/rb-commits/attachments/20230802/1cfe6386/attachment.htm>