Title: Recommend avoiding `abbr` role · Issue #1824 · python/devguide · GitHub
Open Graph Title: Recommend avoiding `abbr` role · Issue #1824 · python/devguide
X Title: Recommend avoiding `abbr` role · Issue #1824 · python/devguide
Description: Describe the enhancement or feature you would like We should avoid using the Sphinx abbr role because it is inaccessible on mobile, screen readers, Braille display, and other touch devices. If you want to use it, spell out in plain text....
Open Graph Description: Describe the enhancement or feature you would like We should avoid using the Sphinx abbr role because it is inaccessible on mobile, screen readers, Braille display, and other touch devices. If you ...
X Description: Describe the enhancement or feature you would like We should avoid using the Sphinx abbr role because it is inaccessible on mobile, screen readers, Braille display, and other touch devices. If you ...
Opengraph URL: https://github.com/python/devguide/issues/1824
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Recommend avoiding `abbr` role","articleBody":"### Describe the enhancement or feature you would like\n\nWe should avoid using the [Sphinx `abbr` role](https://www.sphinx-doc.org/en/master/usage/restructuredtext/roles.html#role-abbr) because it is inaccessible on mobile, screen readers, Braille display, and other touch devices.\n\nIf you want to use it, spell out in plain text.\n\nFor example, instead of:\n\n```rst\n:abbr:`BMP (Basic Multilingual Plane)`\n```\nUse:\n```\nBasic Multilingual Plane (BMP)\n```\n\nSee https://github.com/python/cpython/pull/150673#pullrequestreview-4428977059 for more.\n\n### Describe alternatives you have considered\n\n_No response_\n\n### Additional context\n\n_No response_","author":{"url":"https://github.com/hugovk","@type":"Person","name":"hugovk"},"datePublished":"2026-06-04T15:58:39Z","url":"https://github.com/python/devguide/issues/1824"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| 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:5eac91cd-69ba-23e0-a7f5-a158db9be385 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | EB44:2C3D4F:FE60A2:1556F51:6B005C6E |
| html-safe-nonce | a51d43361c6ea76ab913a5508a7ee05da255ce7caec10554bcd97a168e575879 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJFQjQ0OjJDM0Q0RjpGRTYwQTI6MTU1NkY1MTo2QjAwNUM2RSIsInZpc2l0b3JfaWQiOiIzMTEyODQ4MzU2NDAyMDI3NjMwIiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0= |
| visitor-hmac | 58fe35a9aa14217067f4c9374c4d36d345bd3e710b64038b6d0b53168f492bcd |
| hovercard-subject-tag | issue:4590186367 |
| 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/python/devguide/1824/issue_layout |
| twitter:image | https://opengraph.githubassets.com/3eb0f105fa702706d9117a7de079ece517aaadc085c5ca462d28cd4e5134e9a0/python/devguide/issues/1824 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/3eb0f105fa702706d9117a7de079ece517aaadc085c5ca462d28cd4e5134e9a0/python/devguide/issues/1824 |
| og:image:alt | Describe the enhancement or feature you would like We should avoid using the Sphinx abbr role because it is inaccessible on mobile, screen readers, Braille display, and other touch devices. If you ... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | hugovk |
| hostname | github.com |
| expected-hostname | github.com |
| None | 29be975efff6507a5d135de9c7d634cf7ff8f0c55222a64386ab3202209aaf73 |
| turbo-cache-control | no-preview |
| go-import | github.com/python/devguide git https://github.com/python/devguide.git |
| octolytics-dimension-user_id | 1525981 |
| octolytics-dimension-user_login | python |
| octolytics-dimension-repository_id | 63972479 |
| octolytics-dimension-repository_nwo | python/devguide |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 63972479 |
| octolytics-dimension-repository_network_root_nwo | python/devguide |
| 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 | eacd927ba6112e3b01ba99c762bd699a4a4f5df7 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width