Pico-SDK use of Red Text on Pure Black Background Strains Eyes
@katshann-raspberry y travaille déjà.
Depuis le 10/8/2026.
Évaluation
Cette issue n'a pas encore été évaluée.
Description
The dark theme for the pico-sdk documentation is much appreciated, but it has some rough-edges.
In the pico-sdk, the web page uses a dark-red-text on black background that is very hard on the eyes. This isn't a major issue, but is something that would be very helpful to address and correct -- especially for older eyes.
I'm not a web designer, but have done a lot of dark-theme UI design. The choice of complementary colors that provide proper contrast for readability is crucial. There are a couple of axioms that the current colors used by the pico-sdk violate:
- never use dark text on dark backgrounds, (dark refers to the color-character, where, e.g. red is a "dark" color, while yellow is a "light" color);
- never use pure black for text or backgrounds (e.g.
#000000).
The current pico-sdk violates both. Here is a screenshot from the multicore - fifo documentation:
You can alter the red (or any "dark" color) by reducing the saturation to improve contrast (e.g. #FF6464), but with red that usually ends up looking a bit pinkish or orange, but is still much easier on the eyes than a dark red on black. Cyans work exceptionally well on a "close to black" background (something around #53C6FF) as do faux ambers (like #FFEAB0).
As far as replacing the pure black background with something close to pure black, a black desaturated cyan works really well to eliminate eye-strain. Anything in the range of #070A10 to #18191D works really well. You can even get by with a bit lighter and you can tweak the desaturated offset color to suit your taste. Text renders cleaner on something that isn't pure black and your eyes with thank you. (this github page uses #0D1117 which works fine)
Again, not a major issue, but something very easily corrected by changing a couple of color-codes. Then people would have no excuse for not RTFM...
If this isn't the proper place for this issue, just let me know and I'm happy to migrate it to wherever is proper. I looked at the raspberrypi/documentation repo, but that didn't seem like the right place for pico-sdk doc issues.
- Langage dominant
- Python
- Étoiles
- 5.6k
- Forks
- 2.1k
- Métriques de merge des PR
- Aucune PR mergée en 30 j
Préparer son environnement
- Aucun Dockerfile ni fichier Docker Compose
- Aucun modèle de pull request
- Lire le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de raspberrypi/documentation
-
One Time Programmable memory map incorrectPeut-être à nouveau libre @timg236 l’a pris il y a 85 jours, et aucune pull request n’est ouverte. Ouvertewhite paper
raspberrypi/documentation#4319 · 2 commentaires · 2 personnes assignées ·
-
GPIO and the 40-pin header: legend embedded in associated image is outdatedPeut-être à nouveau libre @stevedavies-rp l’a pris il y a 100 jours, et aucune pull request n’est ouverte. Ouvertebacklog diagram
raspberrypi/documentation#4124 · 3 commentaires · 1 personne assignée ·
-
Solution: Sync Flash to GS Camera with use of the XVS PIN and an Pico or ArduinoPeut-être à nouveau libre @lucyhattersley l’a pris il y a 47 jours, et aucune pull request n’est ouverte. Ouvertebacklog camera 📷 tutorial 📘
raspberrypi/documentation#4034 · 9 commentaires · 1 personne assignée ·
-
Update needed to "Raspberry Pi Debug Probe" for PICO 2Peut-être à nouveau libre @katshann-raspberry l’a pris il y a 100 jours, et aucune pull request n’est ouverte. Ouvertebacklog restructure rp2040
raspberrypi/documentation#4003 · 10 commentaires · 1 personne assignée ·
-
How to change the primary UART of a Raspberry PiPeut-être à nouveau libre @katshann-raspberry l’a pris il y a 99 jours, et aucune pull request n’est ouverte. Ouvertebacklog documentation troubleshooting
raspberrypi/documentation#3938 · 1 commentaire · 1 personne assignée ·
Toutes les issues de raspberrypi/documentation
Issues similaires
-
HassSetVolumeRelative reports no targets (empty success list) although the volume was changedOuverteintegration: media_player
Difficulté 2/5 1-3 heures Accessibilité débutants 82/100
home-assistant/core#193344 · 2 commentaires ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 1/5 Moins d'une heure Accessibilité débutants 82/100
daniel-ospina/tortoise#13607 ·
Les mainteneurs répondent en général sous 1 jour
-
documentation priority: medium
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 2/5 1-3 heures Accessibilité débutants 66/100
Les mainteneurs répondent en général sous 1 jour
-
needs-triage
Difficulté 2/5 1-3 heures Accessibilité débutants 78/100
Les mainteneurs répondent en général sous 1 jour