mbox series

[0/5] Docs build cleanup and automations

Message ID 20260317-docs-releases-json-v1-0-492d0b256349@bootlin.com
Headers show
Series Docs build cleanup and automations | expand

Message

Antonin Godard March 17, 2026, 10:08 a.m. UTC 
This series aims at first simplifying some of the recent code
surrounding the documentation build, and second at automatically
fetching the supported/outdated versions of bitbake from the
releases.json file[1] and outputting a releases.rst document from that.

The remote releases.json file is downloaded once when launching a build,
and re-used on subsequent builds. `make clean` will remove it.

The output is unchanged compared to before. It will only change once the
remote releases.json file gets updated.

[1]: https://dashboard.yoctoproject.org/releases.json

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
Antonin Godard (5):
      doc: move the Git repo check to the conf.py file
      doc/setversions.py: simplify the get_current_version() function
      doc/setversions.py: fix an f-string without placeholders
      doc: build using remote releases.json
      doc: generate the releases.rst file

 doc/.gitignore     |   2 +
 doc/Makefile       |   2 +-
 doc/conf.py        |  13 ++
 doc/releases.rst   | 199 ------------------------------
 doc/setversions.py | 355 ++++++++++++++++++++++++++++++++++++++++++-----------
 5 files changed, 300 insertions(+), 271 deletions(-)
---
base-commit: e8ace6e16c78ddbc2cfe985b88b66800d99282b3
change-id: 20260304-docs-releases-json-f00caf386e79