Docs: update reproducible builds guide

[duboism]

As discussed in #10924, we propose to update the reproducible builds guide (docs/user/guides/reproducible-builds.rst). The goals are:

• update instruction for config v2 file
• clarify that versions in the guide are just example and not recommended
• don't use the buggy sphinx=5.3.0 in the example

---

📚 Documentation previews 📚

• User's documentation (docs): https://docs--10939.org.readthedocs.build/en/10939/

• Developer's documentation (dev): https://dev--10939.org.readthedocs.build/en/10939/

[duboism]

I finished the main proposed modifications.

However, I don't understand the "✅ Good:" badge in Pin your transitive dependencies. Any thoughts ?

[humitos]

Thanks for the PR! I think it's good and ready to merge after some small changes 👍🏼

[duboism]

Sorry for the delay. I commented on the various points you raised and modified the code.

[duboism]

Any news ?

[duboism]

Still no news ?

[ericholscher]

This PR has conflicts -- I think because we addressed the change with the YAML file being required already. So it's probably fine to update this to just include the warning, and I'm fine to merge it.

[htech9]

@duboism You may want to fix the conflicts and address the comment above.

[duboism]

@htech9, sorry I was busy on other duties. I will adress that quickly.

[duboism]

As requested, I updated the branch to just include the warning (and an obvious typo).

[ericholscher]

Thanks :)

[duboism]

Thanks for merging. The world is a little better now :)