Poor color contrast in code blocks for Plotly JS Documentation
@LiamConnors is already working on this.
Since Aug 1, 2025.
Assessment
This issue has not been assessed yet.
Description
The code blocks for each example in the Plotly JS documentation have very low color contrast between the code text and the block background. This is not very accessible and can cause eye strain when trying to read and understand the coding examples. Both light mode and dark mode have the same low contrast issue.
The code blocks for Plotly Python have better color contrast between the code text and the block background, but there is room for improvement.
Behavior is the same between Firefox and Chromium-based browsers. Below are screenshots comparing light and dark modes for both JavaScript and Python docs.
JavaScript
Page: https://plotly.com/javascript/box-plots/
Python
Page: https://plotly.com/python/creating-and-updating-figures/
- Dominant language
- Jupyter Notebook
- Stars
- 59
- Forks
- 73
- Avg merge
- 1d 19h
- Merged PRs (30d)
- 3
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from plotly/graphing-library-docs
-
documentation P2 size: 1
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
plotly/graphing-library-docs#469 ·
-
documentation P1 plotly-internal size: 1
Difficulty 2/5 1-3 hours Newbie friendliness 58/100
plotly/graphing-library-docs#473 ·
-
documentation P2 size: 1
plotly/graphing-library-docs#470 · 1 assignee ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 58/100
plotly/graphing-library-docs#406 ·
-
documentation enhancement
plotly/graphing-library-docs#383 · 1 assignee ·