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

[Quentin Schulz <quentin.schulz@cherry.de>]

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