René's URL Explorer Experiment


Title: Doc: doc docs reorg by story645 · Pull Request #28578 · matplotlib/matplotlib · GitHub

Open Graph Title: Doc: doc docs reorg by story645 · Pull Request #28578 · matplotlib/matplotlib

X Title: Doc: doc docs reorg by story645 · Pull Request #28578 · matplotlib/matplotlib

Description: PR summary Feedback at sprints was that it's kinda confusing to have the doc build docs meshed w/ the doc formatting docs, so: pulled em out into their own page once I was writing new pages, moved all the docs pages so that they have document-* as a prefix so it's easier to identify which dev docs are doc docs -> my bias would be to move em into a docs docs folder, but 🤷‍♀️ if the preference is for flat structure. Note: looking at this now, probably the cleanest split is build instructions writing instructions apply to ALL docs -> .rst formatting guidance, style etc writing instructions that apply to specific docs -> how to write examples, how to write docstrings, etc tagging can remain top level or go under "specific docs" This is part of #26392 and #26196. Follow up would be: clean up the build instructions w/ tables and tabs so it's easier to find specific information separate all the "how to write .rst"/applies to all docs content into the format page, doc type specific guidance into content/style page. attn: @juanis2112 PR checklist [n/a] "closes #0000" is in the body of the PR description to link the related issue [n/a] new and changed code is tested [n/a] Plotting related features are demonstrated in an example [ n/a] New Features and API Changes are noted with a directive and release note Documentation complies with general and docstring guidelines

Open Graph Description: PR summary Feedback at sprints was that it's kinda confusing to have the doc build docs meshed w/ the doc formatting docs, so: pulled em out into their own page once I was writing new pages, ...

X Description: PR summary Feedback at sprints was that it's kinda confusing to have the doc build docs meshed w/ the doc formatting docs, so: pulled em out into their own page once I was writing new pag...

Opengraph URL: https://github.com/matplotlib/matplotlib/pull/28578

X: @github

direct link

Domain: github.com

route-pattern/:user_id/:repository/pull/:id/files(.:format)
route-controllerpull_requests
route-actionfiles
fetch-noncev2:a4326bf1-e57f-45f1-dc26-82a0566c2882
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-idD7F0:2D857A:9CDB10:D35939:6A5312DD
html-safe-nonce89cb999d706ee63694e3364e34fedf85d97ec0819dee8089606b0db42c88ce70
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJEN0YwOjJEODU3QTo5Q0RCMTA6RDM1OTM5OjZBNTMxMkREIiwidmlzaXRvcl9pZCI6IjkxMTMwODYzMjI1NTMwNDQxMyIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9
visitor-hmace16620d5b4ee75aef8161b61189acd15185f691e3b1f19dfbbc7ced8c40e2659
hovercard-subject-tagpull_request:1968646800
github-keyboard-shortcutsrepository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///pull_requests/show/files
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/matplotlib/matplotlib/pull/28578/files
twitter:imagehttps://avatars.githubusercontent.com/u/1300499?s=400&v=4
twitter:cardsummary_large_image
og:imagehttps://avatars.githubusercontent.com/u/1300499?s=400&v=4
og:image:altPR summary Feedback at sprints was that it's kinda confusing to have the doc build docs meshed w/ the doc formatting docs, so: pulled em out into their own page once I was writing new pages, ...
og:site_nameGitHub
og:typeobject
hostnamegithub.com
expected-hostnamegithub.com
Noneb9a586c06a05a7a86fc7e3f4dbd03e42f6869085879aa184aa6369456dbd50fb
turbo-cache-controlno-preview
diff-viewunified
go-importgithub.com/matplotlib/matplotlib git https://github.com/matplotlib/matplotlib.git
octolytics-dimension-user_id215947
octolytics-dimension-user_loginmatplotlib
octolytics-dimension-repository_id1385122
octolytics-dimension-repository_nwomatplotlib/matplotlib
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id1385122
octolytics-dimension-repository_network_root_nwomatplotlib/matplotlib
turbo-body-classeslogged-out env-production page-responsive full-width
disable-turbotrue
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release07a982c1d40157c619b364352b704c3ce66bb332
ui-targetcanary-1
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/matplotlib/matplotlib/pull/28578/files#start-of-content
https://github.com/
Sign in https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fmatplotlib%2Fmatplotlib%2Fpull%2F28578%2Ffiles
GitHub CopilotWrite better code with AIhttps://github.com/features/copilot
GitHub Copilot appDirect agents from issue to mergehttps://github.com/features/ai/github-app
MCP RegistryNewIntegrate external toolshttps://github.com/mcp
ActionsAutomate any workflowhttps://github.com/features/actions
CodespacesInstant dev environmentshttps://github.com/features/codespaces
IssuesPlan and track workhttps://github.com/features/issues
Code ReviewManage code changeshttps://github.com/features/code-review
GitHub Advanced SecurityFind and fix vulnerabilitieshttps://github.com/security/advanced-security
Code securitySecure your code as you buildhttps://github.com/security/advanced-security/code-security
Secret protectionStop leaks before they starthttps://github.com/security/advanced-security/secret-protection
Why GitHubhttps://github.com/why-github
Documentationhttps://docs.github.com
Bloghttps://github.blog
Changeloghttps://github.blog/changelog
Marketplacehttps://github.com/marketplace
View all featureshttps://github.com/features
Enterpriseshttps://github.com/enterprise
Small and medium teamshttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
App Modernizationhttps://github.com/solutions/use-case/app-modernization
DevSecOpshttps://github.com/solutions/use-case/devsecops
DevOpshttps://github.com/solutions/use-case/devops
CI/CDhttps://github.com/solutions/use-case/ci-cd
View all use caseshttps://github.com/solutions/use-case
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
View all industrieshttps://github.com/solutions/industry
View all solutionshttps://github.com/solutions
AIhttps://github.com/resources/articles?topic=ai
Software Developmenthttps://github.com/resources/articles?topic=software-development
DevOpshttps://github.com/resources/articles?topic=devops
Securityhttps://github.com/resources/articles?topic=security
View all topicshttps://github.com/resources/articles
Customer storieshttps://github.com/customer-stories
Events & webinarshttps://github.com/resources/events
Ebooks & reportshttps://github.com/resources/whitepapers
Business insightshttps://github.com/solutions/executive-insights
GitHub Skillshttps://skills.github.com
Documentationhttps://docs.github.com
Customer supporthttps://support.github.com
Community forumhttps://github.com/orgs/community/discussions
Trust centerhttps://github.com/trust-center
Partnershttps://github.com/partners
View all resourceshttps://github.com/resources
GitHub SponsorsFund open source developershttps://github.com/open-source/sponsors
Security Labhttps://securitylab.github.com
Maintainer Communityhttps://maintainers.github.com
Acceleratorhttps://github.com/open-source/accelerator
GitHub Starshttps://stars.github.com
Archive Programhttps://archiveprogram.github.com
Topicshttps://github.com/topics
Trendinghttps://github.com/trending
Collectionshttps://github.com/collections
Enterprise platformAI-powered developer platformhttps://github.com/enterprise
GitHub Advanced SecurityEnterprise-grade security featureshttps://github.com/security/advanced-security
Copilot for BusinessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Pricinghttps://github.com/pricing
Search syntax tipshttps://docs.github.com/search-github/github-code-search/understanding-github-code-search-syntax
documentationhttps://docs.github.com/search-github/github-code-search/understanding-github-code-search-syntax
Sign in https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fmatplotlib%2Fmatplotlib%2Fpull%2F28578%2Ffiles
Sign up https://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fpull_requests%2Fshow%2Ffiles&source=header-repo&source_repo=matplotlib%2Fmatplotlib
Reloadhttps://github.com/matplotlib/matplotlib/pull/28578/files
Reloadhttps://github.com/matplotlib/matplotlib/pull/28578/files
Reloadhttps://github.com/matplotlib/matplotlib/pull/28578/files
Please reload this pagehttps://github.com/matplotlib/matplotlib/pull/28578/files
matplotlib https://github.com/matplotlib
matplotlibhttps://github.com/matplotlib/matplotlib
Please reload this pagehttps://github.com/matplotlib/matplotlib/pull/28578/files
Notifications https://github.com/login?return_to=%2Fmatplotlib%2Fmatplotlib
Fork 8.4k https://github.com/login?return_to=%2Fmatplotlib%2Fmatplotlib
Star 23k https://github.com/login?return_to=%2Fmatplotlib%2Fmatplotlib
Code https://github.com/matplotlib/matplotlib
Issues 1.1k https://github.com/matplotlib/matplotlib/issues
Pull requests 408 https://github.com/matplotlib/matplotlib/pulls
Actions https://github.com/matplotlib/matplotlib/actions
Projects https://github.com/matplotlib/matplotlib/projects
Wiki https://github.com/matplotlib/matplotlib/wiki
Security and quality 0 https://github.com/matplotlib/matplotlib/security
Insights https://github.com/matplotlib/matplotlib/pulse
Code https://github.com/matplotlib/matplotlib
Issues https://github.com/matplotlib/matplotlib/issues
Pull requests https://github.com/matplotlib/matplotlib/pulls
Actions https://github.com/matplotlib/matplotlib/actions
Projects https://github.com/matplotlib/matplotlib/projects
Wiki https://github.com/matplotlib/matplotlib/wiki
Security and quality https://github.com/matplotlib/matplotlib/security
Insights https://github.com/matplotlib/matplotlib/pulse
Sign up for GitHub https://github.com/signup?return_to=%2Fmatplotlib%2Fmatplotlib%2Fissues%2Fnew%2Fchoose
terms of servicehttps://docs.github.com/terms
privacy statementhttps://docs.github.com/privacy
Sign inhttps://github.com/login?return_to=%2Fmatplotlib%2Fmatplotlib%2Fissues%2Fnew%2Fchoose
story645https://github.com/story645
matplotlib:mainhttps://github.com/matplotlib/matplotlib/tree/main
story645:doc-buildhttps://github.com/story645/matplotlib/tree/doc-build
Conversation 8 https://github.com/matplotlib/matplotlib/pull/28578
Commits 1 https://github.com/matplotlib/matplotlib/pull/28578/commits
Checks 0 https://github.com/matplotlib/matplotlib/pull/28578/checks
Files changed https://github.com/matplotlib/matplotlib/pull/28578/files
Please reload this pagehttps://github.com/matplotlib/matplotlib/pull/28578/files
Doc: doc docs reorg https://github.com/matplotlib/matplotlib/pull/28578/files#top
Show all changes 1 commit https://github.com/matplotlib/matplotlib/pull/28578/files
a9fce7f reorged doc docs to have common prefix and seperate doc build page story645 Jul 15, 2024 https://github.com/matplotlib/matplotlib/pull/28578/commits/a9fce7fc796227e8aa16188602b79ae518b7e246
Clear filters https://github.com/matplotlib/matplotlib/pull/28578/files
Please reload this pagehttps://github.com/matplotlib/matplotlib/pull/28578/files
Please reload this pagehttps://github.com/matplotlib/matplotlib/pull/28578/files
contribute.rst https://github.com/matplotlib/matplotlib/pull/28578/files#diff-4818043753a908114215dcb9a1264b64deb51d66a32ca0cf9e500057d13a37c3
development_workflow.rst https://github.com/matplotlib/matplotlib/pull/28578/files#diff-328498381409ff1b89a1d4a7a836c5d98713fc6507b6a8f13a76b4d079c1a623
document_build.rst https://github.com/matplotlib/matplotlib/pull/28578/files#diff-79b61a5b7cb10774864217cd628386ed4fa54f4ab867deafca3187c05b17089d
document_format.rst https://github.com/matplotlib/matplotlib/pull/28578/files#diff-cbf52523118dfe1e510e01ed1c20a545df59da17b1177dcfb541653aa1218d93
document_style.rst https://github.com/matplotlib/matplotlib/pull/28578/files#diff-6245f3d50080bbc77fe87916480c1aefa1bac4073ada64c97747b6fa78c1ff66
document_tag.rst https://github.com/matplotlib/matplotlib/pull/28578/files#diff-ca2c60ba31be1f19fd13e0c538e528642c1dfd747fe9a82db05ca48a4e648e0e
document_tag_glossary.rst https://github.com/matplotlib/matplotlib/pull/28578/files#diff-ecaf2a7fbe7183651e927d65543bd063ec7f0fed6d3cb10e5b9eba7ae6005d90
index.rst https://github.com/matplotlib/matplotlib/pull/28578/files#diff-a09d4abbcf2f9cf30330d80e40b76b11f2c283310399c535b755d257912e7398
doc/devel/contribute.rsthttps://github.com/matplotlib/matplotlib/pull/28578/files#diff-4818043753a908114215dcb9a1264b64deb51d66a32ca0cf9e500057d13a37c3
View file https://github.com/matplotlib/matplotlib/blob/a9fce7fc796227e8aa16188602b79ae518b7e246/doc/devel/contribute.rst
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/matplotlib/matplotlib/pull/28578/{{ revealButtonHref }}
https://github.com/matplotlib/matplotlib/pull/28578/files#diff-4818043753a908114215dcb9a1264b64deb51d66a32ca0cf9e500057d13a37c3
https://github.com/matplotlib/matplotlib/pull/28578/files#diff-4818043753a908114215dcb9a1264b64deb51d66a32ca0cf9e500057d13a37c3
doc/devel/development_workflow.rsthttps://github.com/matplotlib/matplotlib/pull/28578/files#diff-328498381409ff1b89a1d4a7a836c5d98713fc6507b6a8f13a76b4d079c1a623
View file https://github.com/matplotlib/matplotlib/blob/a9fce7fc796227e8aa16188602b79ae518b7e246/doc/devel/development_workflow.rst
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/matplotlib/matplotlib/pull/28578/{{ revealButtonHref }}
https://github.com/matplotlib/matplotlib/pull/28578/files#diff-328498381409ff1b89a1d4a7a836c5d98713fc6507b6a8f13a76b4d079c1a623
https://github.com/matplotlib/matplotlib/pull/28578/files#diff-328498381409ff1b89a1d4a7a836c5d98713fc6507b6a8f13a76b4d079c1a623
doc/devel/document_build.rsthttps://github.com/matplotlib/matplotlib/pull/28578/files#diff-79b61a5b7cb10774864217cd628386ed4fa54f4ab867deafca3187c05b17089d
View file https://github.com/matplotlib/matplotlib/blob/a9fce7fc796227e8aa16188602b79ae518b7e246/doc/devel/document_build.rst
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/matplotlib/matplotlib/pull/28578/{{ revealButtonHref }}
doc/devel/document.rst → doc/devel/document_format.rsthttps://github.com/matplotlib/matplotlib/pull/28578/files#diff-cbf52523118dfe1e510e01ed1c20a545df59da17b1177dcfb541653aa1218d93
View file https://github.com/matplotlib/matplotlib/blob/a9fce7fc796227e8aa16188602b79ae518b7e246/doc/devel/document_format.rst
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/matplotlib/matplotlib/pull/28578/{{ revealButtonHref }}
https://github.com/matplotlib/matplotlib/pull/28578/files#diff-cbf52523118dfe1e510e01ed1c20a545df59da17b1177dcfb541653aa1218d93
https://github.com/matplotlib/matplotlib/pull/28578/files#diff-cbf52523118dfe1e510e01ed1c20a545df59da17b1177dcfb541653aa1218d93
doc/devel/style_guide.rst → doc/devel/document_style.rsthttps://github.com/matplotlib/matplotlib/pull/28578/files#diff-6245f3d50080bbc77fe87916480c1aefa1bac4073ada64c97747b6fa78c1ff66
View file https://github.com/matplotlib/matplotlib/blob/a9fce7fc796227e8aa16188602b79ae518b7e246/doc/devel/document_style.rst
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/matplotlib/matplotlib/pull/28578/{{ revealButtonHref }}
https://github.com/matplotlib/matplotlib/pull/28578/files#diff-6245f3d50080bbc77fe87916480c1aefa1bac4073ada64c97747b6fa78c1ff66
https://github.com/matplotlib/matplotlib/pull/28578/files#diff-6245f3d50080bbc77fe87916480c1aefa1bac4073ada64c97747b6fa78c1ff66
https://github.com/matplotlib/matplotlib/pull/28578/files#diff-6245f3d50080bbc77fe87916480c1aefa1bac4073ada64c97747b6fa78c1ff66
doc/devel/tag_guidelines.rst → doc/devel/document_tag.rsthttps://github.com/matplotlib/matplotlib/pull/28578/files#diff-ca2c60ba31be1f19fd13e0c538e528642c1dfd747fe9a82db05ca48a4e648e0e
View file https://github.com/matplotlib/matplotlib/blob/a9fce7fc796227e8aa16188602b79ae518b7e246/doc/devel/document_tag.rst
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/matplotlib/matplotlib/pull/28578/{{ revealButtonHref }}
https://github.com/matplotlib/matplotlib/pull/28578/files#diff-ca2c60ba31be1f19fd13e0c538e528642c1dfd747fe9a82db05ca48a4e648e0e
https://github.com/matplotlib/matplotlib/pull/28578/files#diff-ca2c60ba31be1f19fd13e0c538e528642c1dfd747fe9a82db05ca48a4e648e0e
https://github.com/matplotlib/matplotlib/pull/28578/files#diff-ca2c60ba31be1f19fd13e0c538e528642c1dfd747fe9a82db05ca48a4e648e0e
doc/devel/tag_glossary.rst → doc/devel/document_tag_glossary.rsthttps://github.com/matplotlib/matplotlib/pull/28578/files#diff-ecaf2a7fbe7183651e927d65543bd063ec7f0fed6d3cb10e5b9eba7ae6005d90
View file https://github.com/matplotlib/matplotlib/blob/a9fce7fc796227e8aa16188602b79ae518b7e246/doc/devel/document_tag_glossary.rst
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/matplotlib/matplotlib/pull/28578/{{ revealButtonHref }}
https://github.com/matplotlib/matplotlib/pull/28578/files#diff-ecaf2a7fbe7183651e927d65543bd063ec7f0fed6d3cb10e5b9eba7ae6005d90
doc/devel/index.rsthttps://github.com/matplotlib/matplotlib/pull/28578/files#diff-a09d4abbcf2f9cf30330d80e40b76b11f2c283310399c535b755d257912e7398
View file https://github.com/matplotlib/matplotlib/blob/a9fce7fc796227e8aa16188602b79ae518b7e246/doc/devel/index.rst
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/matplotlib/matplotlib/pull/28578/{{ revealButtonHref }}
https://github.com/matplotlib/matplotlib/pull/28578/files#diff-a09d4abbcf2f9cf30330d80e40b76b11f2c283310399c535b755d257912e7398
https://github.com/matplotlib/matplotlib/pull/28578/files#diff-a09d4abbcf2f9cf30330d80e40b76b11f2c283310399c535b755d257912e7398
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width


URLs of crawlers that visited me.