Title: Extract the development docs from this repository · Issue #22866 · matplotlib/matplotlib · GitHub
Open Graph Title: Extract the development docs from this repository · Issue #22866 · matplotlib/matplotlib
X Title: Extract the development docs from this repository · Issue #22866 · matplotlib/matplotlib
Description: We have historically built all of our documentation from the sphinx source in the main matplotlib/matplotlib repo (this one). We would then host this by unpacking the result of the build at the top level of website + into a version speci...
Open Graph Description: We have historically built all of our documentation from the sphinx source in the main matplotlib/matplotlib repo (this one). We would then host this by unpacking the result of the build at the top...
X Description: We have historically built all of our documentation from the sphinx source in the main matplotlib/matplotlib repo (this one). We would then host this by unpacking the result of the build at the top...
Opengraph URL: https://github.com/matplotlib/matplotlib/issues/22866
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Extract the development docs from this repository","articleBody":"We have historically built all of our documentation from the sphinx source in the main matplotlib/matplotlib repo (this one). We would then host this by unpacking the result of the build at the top level of website + into a version specific sub-folder. We would also rely on \r\n\r\nWhile this served us well for over a decade, over the past few years we have slowly started to pull things apart. The goal is to ultimately de-couple the version independent parts of the documentation (which should be re-published as soon as they are update) from the version-specific docs (which should be Steps we have already taken so far:\r\n\r\n - move the cannonical docs to https://matplotlib.org/stable https://discourse.matplotlib.org/t/canonical-documentation-have-moved/21863\r\n - split the third-party docs out into its own repo https://github.com/matplotlib/mpl-third-party\r\n - have a sphinx theme for all of our websites https://github.com/matplotlib/mpl-sphinx-theme\r\n - split the top-level index into its own repo https://github.com/matplotlib/mpl-brochure-site\r\n - have built docs for the governance https://github.com/matplotlib/governance\r\n - moved our ground-truth hosting to digital ocean https://github.com/matplotlib/matplotlib.org\r\n\r\nThe next thing we should pull out into its own repository is the content under https://matplotlib.org/stable/devel/index.html . We probably should copy-paste the GHA/sphinx configuration from the governance repo and update the rst in that framework.\r\n\r\nWe should do this as a second step after we finish @noatamir 's update of that content (to make it easier to review the changes at each step).","author":{"url":"https://github.com/tacaswell","@type":"Person","name":"tacaswell"},"datePublished":"2022-04-20T15:17:45.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":17},"url":"https://github.com/22866/matplotlib/issues/22866"}
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:735efe8f-40b8-ad48-9f0c-23ee4a6f00ca |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | 85F0:33E60B:BCB551:FEC71E:6A531D11 |
| html-safe-nonce | 382423b7ddeccdeff91fba5346657003c9d1e91b84bc9f06f6bad1f2cc019e3c |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI4NUYwOjMzRTYwQjpCQ0I1NTE6RkVDNzFFOjZBNTMxRDExIiwidmlzaXRvcl9pZCI6IjY4MjI1OTEwOTIzMzQyMDYyMjUiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ== |
| visitor-hmac | a41c83dee23880e4b291a2561763f5de2fdbef969a03e09b5d652d8111b01708 |
| hovercard-subject-tag | issue:1209838041 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/matplotlib/matplotlib/22866/issue_layout |
| twitter:image | https://opengraph.githubassets.com/620c427ee15beb9a9721a1c1b85f6b4fec970e44beefb798ceb9bc661084e729/matplotlib/matplotlib/issues/22866 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/620c427ee15beb9a9721a1c1b85f6b4fec970e44beefb798ceb9bc661084e729/matplotlib/matplotlib/issues/22866 |
| og:image:alt | We have historically built all of our documentation from the sphinx source in the main matplotlib/matplotlib repo (this one). We would then host this by unpacking the result of the build at the top... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | tacaswell |
| hostname | github.com |
| expected-hostname | github.com |
| None | b9a586c06a05a7a86fc7e3f4dbd03e42f6869085879aa184aa6369456dbd50fb |
| turbo-cache-control | no-preview |
| go-import | github.com/matplotlib/matplotlib git https://github.com/matplotlib/matplotlib.git |
| octolytics-dimension-user_id | 215947 |
| octolytics-dimension-user_login | matplotlib |
| octolytics-dimension-repository_id | 1385122 |
| octolytics-dimension-repository_nwo | matplotlib/matplotlib |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 1385122 |
| octolytics-dimension-repository_network_root_nwo | matplotlib/matplotlib |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 07a982c1d40157c619b364352b704c3ce66bb332 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
Links:
Viewport: width=device-width