Skip to content

Commit 4a796a7

Browse files
JohnMcLearclaude
andcommitted
docs(7138): rephrase fade rationale around busy-pad color collisions
Each faded author counts as a second on-screen color, so a 30-author pad visually becomes a 60-color pad — that's the primary motivation for disabling the fade. The previous wording only mentioned "users picking light colors", which missed the larger reason and the "or just don't want inactivity tracking" case. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 51a258f commit 4a796a7

2 files changed

Lines changed: 5 additions & 4 deletions

File tree

doc/docker.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -115,7 +115,7 @@ If your database needs additional settings, you will have to use a personalized
115115
| `PAD_OPTIONS_ALWAYS_SHOW_CHAT` | | `false` |
116116
| `PAD_OPTIONS_CHAT_AND_USERS` | | `false` |
117117
| `PAD_OPTIONS_LANG` | | `null` |
118-
| `PAD_OPTIONS_FADE_INACTIVE_AUTHOR_COLORS` | Fade each author's caret/background toward white as they go inactive. Set to `false` if users pick light colors that become indistinguishable from the faded variants. | `true` |
118+
| `PAD_OPTIONS_FADE_INACTIVE_AUTHOR_COLORS` | Fade each author's caret/background toward white as they go inactive. Set to `false` on busy pads (every faded author counts as a second on-screen color, so 30 contributors visually become 60), when users pick light colors that fade into the background, or whenever inactivity tracking is undesirable. | `true` |
119119

120120

121121
### Shortcuts

src/static/js/ace2_inner.ts

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -237,9 +237,10 @@ function Ace2Inner(editorInfo, cssManagers) {
237237
} else if (info.bgcolor) {
238238
let bgcolor = info.bgcolor;
239239
// padOptions.fadeInactiveAuthorColors (default true) controls whether the author
240-
// background fades toward white as the author goes inactive. Integrators can set
241-
// it to false server-side when users pick light colors that become indistinguishable
242-
// from the faded variants.
240+
// background fades toward white as the author goes inactive. Integrators set it to
241+
// false on busy pads (each faded author is effectively a second on-screen color, so
242+
// a 30-author pad becomes a 60-color pad), or when inactivity tracking is undesirable
243+
// for whatever reason.
243244
const fadeEnabled = window.clientVars.padOptions == null ||
244245
window.clientVars.padOptions.fadeInactiveAuthorColors !== false;
245246
if (fadeEnabled && (typeof info.fade) === 'number') {

0 commit comments

Comments
 (0)