plotly / plotly/graphing-library-docs

Poor color contrast in code blocks for Plotly JS Documentation

Open
#378 0 comments 0 reactions 1 assignee View on GitHub

@LiamConnors is already working on this.

Since Aug 1, 2025.

documentation enhancement
Dominant language
Jupyter Notebook
Stars
59
Forks
72
Avg merge
1d 19h
Merged PRs (30d)
3

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/

Image Image

Python

Page: https://plotly.com/python/creating-and-updating-figures/

Image Image

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.