Skip to content

docs(terminology): retire the stale develop seed — one latest TERMINOLOGY.md#63

Open
LukasWodka wants to merge 1 commit into
developfrom
docs/terminology-retire-seed
Open

docs(terminology): retire the stale develop seed — one latest TERMINOLOGY.md#63
LukasWodka wants to merge 1 commit into
developfrom
docs/terminology-retire-seed

Conversation

@LukasWodka

@LukasWodka LukasWodka commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

develop still had the 40-line seed while main has the 184-line v2 (docs#61) — the divergence that twice caused a wrong 'secure environment vs workspace' read. This syncs develop's TERMINOLOGY.md to the v2 so there's one latest, not two.

Docs-only; safe to merge (docs exempt from the FR-gate).


Note

Low Risk
Single markdown file on the docs branch; no code, auth, or data paths affected.

Overview
Aligns develop with main on product vocabulary by replacing the old 40-line seed TERMINOLOGY.md with the full v2 glossary (docs#61), eliminating two conflicting “latest” copies that had already caused wrong reads on secure environment vs workspace.

The updated file marks itself authoritative for UI, docs, CLI, and skills; records secure environment (2026-07-12) as the on-prem term; expands tables for people, task taxonomy (16 tasks + layouts), training, models, FL, brand, CLI verbs, and engineering naming; adds a words to retire sweep tied to live code/UI drift; and lists open questions (Hub vs dashboard, owner label, model verb, etc.) with explicit note that renames follow decisions—not this PR alone.

Docs-only change — no runtime or API behavior.

Reviewed by Cursor Bugbot for commit 67dfdae. Bugbot is set up for automated code reviews on this repo. Configure here.

…le source of truth

develop still had the 40-line seed while main has the 184-line v2 (docs#61),
which caused the wrong 'secure environment vs workspace' read. Bring develop's
copy in line with main so there is one latest TERMINOLOGY.md, not two.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 2 potential issues.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Want fixes drafted automatically? Bugbot Autofix can create code changes for findings. A team admin can enable Autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit 67dfdae. Configure here.

Comment thread TERMINOLOGY.md
| Thing | Today | Proposed |
|---|---|---|
| Helm chart that deploys the secure environment | `client` repo | **environment-chart** |
| Training-execution container images | `tracebloc-client` repo | keep; describe as "training images" |

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Stale training-images repo name

Medium Severity

Section 9 proposes keeping the tracebloc-client repo name for training-execution images. That violates the decided canonical naming rule: the repo was renamed to tracebloc-engine, so the authoritative terminology file should not instruct people to keep the retired name.

Fix in Cursor Fix in Web

Triggered by learned rule: Flag retired terminology — use decided canonical terms

Reviewed by Cursor Bugbot for commit 67dfdae. Configure here.

Comment thread TERMINOLOGY.md

- **competition / PrivateCompetition** → **use case** *(frontend ×782, backend `Competition` model + route)*
- **workspace** → **secure environment** *(docs, website hero, decks, and the `communication` skill's Terminology Bible)*
- **edge / edge device / EdgeDevice** → **secure environment / client** *(frontend "edge" ×449, backend `EdgeDevice`)*

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Edge rename allows client

Medium Severity

Words to retire maps user-facing edge / edge device to secure environment / client, including frontend copy. For on-prem deployment the decided canonical term is secure environment, not client, so listing client as a replacement target invites the retired term back into product UI.

Fix in Cursor Fix in Web

Triggered by learned rule: Flag retired terminology — use decided canonical terms

Reviewed by Cursor Bugbot for commit 67dfdae. Configure here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant