Re: [docs] [PATCH 2/2] Makefile: add a releases.json target

Quentin Schulz
2026-02-25T14:10:43Z

Hi Antonin,

Please provide context, what is this helping with?

On 2/25/26 1:06 PM, Antonin Godard via lists.yoctoproject.org wrote:
> Add a new releases.json target which can be used to update the
> releases.json file manually. It is called from the publish target only
> (which is the one used on the Autobuilder).
>
> A warning is printed when the file is not up-to-date anymore.
>
> Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
> ---
> documentation/Makefile | 9 +++++++--
> documentation/tools/host_packages_scripts/almalinux_docs.sh | 2 +-
> documentation/tools/host_packages_scripts/fedora_docs.sh | 2 +-
> documentation/tools/host_packages_scripts/opensuse_docs.sh | 2 +-
> documentation/tools/host_packages_scripts/ubuntu_docs.sh | 2 +-
> 5 files changed, 11 insertions(+), 6 deletions(-)
>
> diff --git a/documentation/Makefile b/documentation/Makefile
> index e144a50b4..00c7d957d 100644
> --- a/documentation/Makefile
> +++ b/documentation/Makefile
> @@ -24,9 +24,9 @@ endif
> help:
> @$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
>
> -.PHONY: all checks help Makefile clean stylecheck publish epub latexpdf
> +.PHONY: all checks help Makefile clean stylecheck publish epub latexpdf releases.json
>
> -publish: Makefile checks epub latexpdf html singlehtml
> +publish: releases.json Makefile checks epub latexpdf html singlehtml
> rm -rf $(BUILDDIR)/$(DESTDIR)/
> mkdir -p $(BUILDDIR)/$(DESTDIR)/
> cp -r $(BUILDDIR)/html/* $(BUILDDIR)/$(DESTDIR)/
> @@ -73,6 +73,11 @@ latexpdf: $(PDFs)
> $(SOURCEDIR)/set_versions.py
> buf_size=10000000 $(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
>
> +releases.json:
> + command -v curl jq || echo "curl and jq need to be installed for this target"
> + curl https://dashboard.yoctoproject.org/releases.json | jq --indent 2 >$(SOURCEDIR)/releases.json

Do we really need jq? What is this bringing? It won't be human-consumed
anyway, so who cares for the indent?

Why do we need to download the file during the publish state? Cannot we
make the autobuilder download the file and put it in the right place?
This will also avoid the case where the file gets changed while the
autobuilder builds one earlier release and the latest one.

Cheers,
Quentin