Skip to content

DOC: Rename gallery README.txt files to GALLERY_HEADER.rst#31399

Merged
QuLogic merged 1 commit intomatplotlib:mainfrom
timhoffm:doc-gallery-header
Mar 27, 2026
Merged

DOC: Rename gallery README.txt files to GALLERY_HEADER.rst#31399
QuLogic merged 1 commit intomatplotlib:mainfrom
timhoffm:doc-gallery-header

Conversation

@timhoffm
Copy link
Member

@timhoffm timhoffm commented Mar 26, 2026

GALLERY_HEADER.rst is a more telling name and avoids confusion with regular READMEs. It's the recommend name for sphinx-gallery nowadays. For details see
sphinx-gallery/sphinx-gallery#1209

Using GALLERY_HEADER.rst is supported since sphinx-gallery 0.17 (released Jul 2024), so we need to bump the sphinx-gallery version.

@github-actions github-actions bot added Documentation: examples files in galleries/examples Documentation: user guide files in galleries/users_explain or doc/users labels Mar 26, 2026
@timhoffm timhoffm force-pushed the doc-gallery-header branch 2 times, most recently from f4e8e20 to 77bcb95 Compare March 26, 2026 21:30
GALLERY_HEADER.rst is a more telling name and avoids confusion with
regular READMEs. It's the name recommended by sphinx-gallery nowadays.
For details see
sphinx-gallery/sphinx-gallery#1209

Using GALLERY_HEADER.rst is supported since sphinx-gallery 0.17
(released Jul 2024),so we need to bump the sphinx-gallery version.
@timhoffm timhoffm force-pushed the doc-gallery-header branch from 77bcb95 to 291b5cb Compare March 26, 2026 21:34
@github-actions github-actions bot added the Documentation: plot types files in galleries/plot_types label Mar 26, 2026
@QuLogic QuLogic added this to the v3.11.0 milestone Mar 27, 2026
@QuLogic
Copy link
Member

QuLogic commented Mar 27, 2026

Docs build passed and the rest of the failures are fixed by #31401, but shouldn't be affected by this PR, so merging.

@QuLogic QuLogic merged commit 7c54133 into matplotlib:main Mar 27, 2026
24 of 35 checks passed
@timhoffm timhoffm deleted the doc-gallery-header branch March 27, 2026 06:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Documentation: examples files in galleries/examples Documentation: plot types files in galleries/plot_types Documentation: user guide files in galleries/users_explain or doc/users

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants