Title: [Doc]: A default of `None` should be properly documented as a default of `None` · Issue #31264 · matplotlib/matplotlib · GitHub
Open Graph Title: [Doc]: A default of `None` should be properly documented as a default of `None` · Issue #31264 · matplotlib/matplotlib
X Title: [Doc]: A default of `None` should be properly documented as a default of `None` · Issue #31264 · matplotlib/matplotlib
Description: Documentation Link https://matplotlib.org/devdocs/devel/document.html#default-values Problem I feel strongly enough about this to create an issue: see the discussion between me and Elliott here: #31262 (comment) In particular, this parag...
Open Graph Description: Documentation Link https://matplotlib.org/devdocs/devel/document.html#default-values Problem I feel strongly enough about this to create an issue: see the discussion between me and Elliott here: #3...
X Description: Documentation Link https://matplotlib.org/devdocs/devel/document.html#default-values Problem I feel strongly enough about this to create an issue: see the discussion between me and Elliott here: #3...
Opengraph URL: https://github.com/matplotlib/matplotlib/issues/31264
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"[Doc]: A default of `None` should be properly documented as a default of `None`","articleBody":"### Documentation Link\n\n[https://matplotlib.org/devdocs/devel/document.html#default-values](https://matplotlib.org/devdocs/devel/document.html#default-values)\n\n### Problem\n\nI feel strongly enough about this to create an issue: see the discussion between me and Elliott here: https://github.com/matplotlib/matplotlib/pull/31262#issuecomment-4028349373\n\nIn particular, this paragraph from \"Write documentation\" is well outside of the norm, in my experience:\n\n\u003e If None is only used as a sentinel value for \"parameter not specified\", do not document it as the default. Depending on the context, give the actual default, or mark the parameter as optional if not specifying has no particular effect.\n","author":{"url":"https://github.com/kdpenner","@type":"Person","name":"kdpenner"},"datePublished":"2026-03-10T04:55:51.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":9},"url":"https://github.com/31264/matplotlib/issues/31264"}
| 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:e5ebcafd-80aa-6aad-4ac2-d55e39b7fc2d |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | C84A:1F08C5:5DFFC1:7C382B:6A53EE62 |
| html-safe-nonce | f2cb8eee250b3c62aac6d26dd3d56ab74da0c58defb92f5f2564be3b223b1894 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJDODRBOjFGMDhDNTo1REZGQzE6N0MzODJCOjZBNTNFRTYyIiwidmlzaXRvcl9pZCI6IjI5NTA3MDc1NjQ3NDY3MTA3IiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0= |
| visitor-hmac | abdce31baa5b443c1e8f59dca9876362196906fd7277449e0877406e65b1706c |
| hovercard-subject-tag | issue:4049395126 |
| 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/31264/issue_layout |
| twitter:image | https://opengraph.githubassets.com/b2e03ec253c70f3d888bbca3230151d93615f22a4f29993e58e8e23094cfd22a/matplotlib/matplotlib/issues/31264 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/b2e03ec253c70f3d888bbca3230151d93615f22a4f29993e58e8e23094cfd22a/matplotlib/matplotlib/issues/31264 |
| og:image:alt | Documentation Link https://matplotlib.org/devdocs/devel/document.html#default-values Problem I feel strongly enough about this to create an issue: see the discussion between me and Elliott here: #3... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | kdpenner |
| 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