release(website): light-theme chip contrast + anglicism cleanup across all 21 guides#355
Merged
Conversation
…sm cleanup
## Light-theme chip contrast (blog-theme.css)
Lesson HTMLs hardcode pastel chip colors (#86efac, #fca5a5, #fcd34d,
#93c5fd, #f9a8d4) on faint backgrounds. Fine on dark bg, fails WCAG AA
on the cream light bg (~1.6:1 instead of >=4.5:1).
Added html.light overrides for 6 color families across all guides:
GREEN (.verdict.supports, .verdict-pill.supports, .hpill.h3,
.mt-marker.next, .g-status.pass, .ws-status.active,
.cl-pill.cl3, .ic-row.additive .ic-type, .agent-pill.a2,
.node.adr, .node.spec) -> #166534 (forest green)
RED (.verdict.refutes, .verdict-pill.refutes, .hpill.h1,
.mt-marker.fix, .cl-pill.cl0) -> #991b1b (dark red)
AMBER (.verdict.weakens, .verdict-pill.weakens, .mt-marker.wait,
.cl-pill.cl1, .agent-pill.a3, .cl2, .node.evid) -> #92400e
BLUE (.mt-marker.or, .node.prd, .node.rfc, .agent-pill.a1,
.oc-pill.theory) -> #1e3a8a (dark navy)
PINK (.oc-pill.interactive) -> #831843 (dark magenta)
GRAY (.hpill.h2) -> #404040
Selectors live in blog-theme.css because embed-html.js prefixes every
lesson selector with .guide-embedded, making html.light unreachable
from inside a lesson <style>.
## Anglicism cleanup (11 guide HTML files)
Replaced colloquial anglicisms with plain Russian in visible text.
Kept technical terms (FPF, R_eff, MCP, CLI, pattern IDs, brand names,
git workflow words) as-is. Examples:
pipeline -> конвейер
workflow -> порядок работы
edge cases -> граничные случаи
bottleneck -> узкое место
deploy / staging -> выкатить / тестовый стенд
postmortem -> разбор инцидента
dashboard -> панель
bug-fix -> баг-фикс (баг прижилось)
promo / promotion -> повышение
hiring-manager -> нанимающий менеджер
Files touched: agent-protocol-cycle, bmad-cycle, decision-cycle,
depth-calibrator, evidence-and-decay, first-artifact, forgeplan-cycle,
how-to-use, index, multi-agent-cycle, trust-calculus.
Total ~30 anglicism replacements; CSS class names, JS code, inline
<script> blocks, code-блоки, и HTML-комментарии не тронуты.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Follow-up to the first pass. Caught ~18 more colloquial anglicisms that were missed because the first agent was too conservative on the 10 files that initially reported "0 changes". Files: adi-overview, artifacts-overview, dag-explorer, ddr-format, fpf-cycle, lifecycle-cycle, spec-cycle, trust-calculus-overview. Replacements: - Score / score (as a noun) -> оценка - Behavior -> Поведение - Triggers -> Триггеры - Layout -> Разметка - Knowledge (in headings) -> Знания - Production (as deployment env description) -> продакшен - stale (in prose) -> устаревший Technical state literals (e.g. JS string "stale" in code blocks), product names (LanceDB, Vault), pattern IDs, FPF/Forgeplan methodology terms (Trust Calculus, Bounded Context, Abduction), and lifecycle state values in JS data structures kept as-is. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
fix(website/guides): light-theme chip contrast (6 families) + anglicism cleanup
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Release `dev -> main` carrying PR #354 (2 commits, +105/-64).
What ships
Light-theme chip contrast (`blog-theme.css`)
Added `html.light` overrides for all 6 chip color families (green / red / amber / blue / pink / gray) used across all 21 guide lessons. Was ~1.6:1 contrast on cream bg, now ~7.5:1 (WCAG AA pass).
Anglicism cleanup (~48 replacements across all 21 guide HTML files)
First pass: 11 files, ~30 replacements (pipeline / workflow / dashboard / postmortem / bottleneck / etc).
Second pass: 6 more files, ~18 replacements (Score / Behavior / Triggers / Layout / Knowledge / etc).
Technical terms (FPF, R_eff, MCP, pattern IDs, product names like LanceDB / Vault, git workflow words, lifecycle state literals in JS) kept as-is.
Commits
```
b269a35 Merge pull request #354 from ForgePlan/fix/guides-light-chips-anglicisms
a5b67cf fix(website/guides): second-pass anglicism cleanup in 6 more guide files
dcdfaa5 fix(website/guides): light-theme chip contrast (6 families) + anglicism cleanup
```
Test plan (after merge + deploy)
🤖 Generated with Claude Code