Skip to content

docs: add a GitHub Pages site visualizing stdlib versions across Julia releases - #56

Merged
IanButterworth merged 1 commit into
mainfrom
ib/docs-site
Sep 15, 2026
Merged

IanButterworth merged 1 commit into
mainfrom
ib/docs-site

Conversation

@IanButterworth

Copy link
Copy Markdown
Member

Claude:


Adds a GitHub Pages site that shows which version of each stdlib shipped with each Julia release, built from src/version_map.jl. It is not a Documenter site: the only content is an interactive chart, so docs/make.jl includes the data files directly, exports them to JSON and copies a static page into docs/build/, with no extra dependencies.

Rows are stdlibs and columns are the tracked releases. Consecutive releases that shipped the same version merge into one bar, and colour deepens with each bump so churn is visible at a glance. Clicking a release lists what was added, removed or bumped versus the previous tracked release. Clicking a stdlib shows its version history, dependencies and dependents. There is a table view, name filter, libraries/JLL toggle, sort options, a density control that fits all releases on screen, and light and dark themes.

The workflow builds on pushes and PRs to main and deploys only from main. It passes enablement: true to configure-pages, which should turn Pages on with the default token on the first run. If that step fails, Pages needs to be set to the GitHub Actions source in the repo settings and the workflow rerun.

The data cannot tell a nightly build from a release, so the newest column may come from a nightly. The page says so in its intro.

…a releases

Adds a static site, deployed to GitHub Pages, that renders the contents of
`src/version_map.jl` as an interactive timeline: rows are stdlibs, columns
are the tracked Julia releases, and consecutive releases that shipped the
same stdlib version merge into one bar. Clicking a release lists what was
added, removed or bumped; clicking a stdlib shows its version history,
dependencies and dependents. A table view, filters, sort options and a
density control are included.

This is deliberately not a Documenter site. `docs/make.jl` includes the
data files directly and writes `docs/build/` with no extra dependencies.
The workflow builds on pushes and PRs to main and deploys from main only.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@IanButterworth
IanButterworth merged commit 094ca3e into main Sep 15, 2026
4 of 5 checks passed
@IanButterworth
IanButterworth deleted the ib/docs-site branch September 15, 2026 23:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant