saltstack / saltstack/salt

[DOCS] Include sitemap creation in the docs HTML bundle asset uploads for releases, and ensure last update timestamps present

Open
#70,241 0 comments 0 reactions 1 assignee View on GitHub

@scriptautomate-bc is already working on this.

Since Sep 5, 2026.

documentation
Dominant language
Python
Stars
15.7k
Forks
5.6k
Avg merge
2d 44m
Merged PRs (30d)
80

Description

Description

Though sitemaps can be generated via the docs make file, the default behavior in generating documentation is not including the sitemap nor including the last update timestamps for each item listed.

These improvements across the docs will assist with AI agent (for scraping/training, and otherwise) or search engine crawlers/scrapers for understanding when certain docs have last been updated.

This is a natural follow-up to:

Suggested Fix

A published sitemap, and for the sitemap to have last update timestamps.

Type of documentation
Salt documentation

Location or format of documentation

Should exist:

Which can then all be referenced by a base, top-level sitemap generated by builddocs when all docs are generated/deployed (this can be a follow-up issue/PR inside of builddocs repo):

Additional context

Related:

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.