Skip to content

DOC: update and slightly reorg docs docs#31010

Merged
timhoffm merged 1 commit intomatplotlib:mainfrom
story645:misc-doc
Jan 23, 2026
Merged

DOC: update and slightly reorg docs docs#31010
timhoffm merged 1 commit intomatplotlib:mainfrom
story645:misc-doc

Conversation

@story645
Copy link
Copy Markdown
Member

@story645 story645 commented Jan 22, 2026

Updated the file structure content because it was out of date. Pulled some out into a preamble, but ideally the preamble for this doc should be a summary of the doc types like the one proposed in #26389 (& I might do that as a follow up PR).

Reorganize the documentation docs structure a drop to remove the miscellaneous section, as roughly discussed in #28578

  • "move documentation" moved under "write ReST" since it's mostly instructions on using a directive (like most of the content under write rest)
  • "navbar and style" moved under "overview" since it's also a "how to find things"
  • pulled out build into stand alone section w/ "options" and "show" as subsections

PR summary

PR checklist

@story645
Copy link
Copy Markdown
Member Author

Doc build failures unrelated to this pr :/

Copy link
Copy Markdown
Member

@timhoffm timhoffm left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Take or leave my comments

@timhoffm timhoffm added this to the v3.11.0 milestone Jan 23, 2026
@timhoffm timhoffm merged commit 0c12607 into matplotlib:main Jan 23, 2026
18 of 20 checks passed
@timhoffm
Copy link
Copy Markdown
Member

For now I don't take care to do backports on docs because 3.11 should come out "soon". Feel free to backport if you care.

@story645
Copy link
Copy Markdown
Member Author

It's dev docs, they don't need backports.

@story645 story645 mentioned this pull request Jan 23, 2026
11 tasks
@story645 story645 deleted the misc-doc branch January 23, 2026 20:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Documentation: devdocs files in doc/devel

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants