Skip to content

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

Merged
LukasWodka merged 2 commits into
developfrom
docs/terminology-retire-seed
Jul 23, 2026
Merged

docs(terminology): retire the stale develop seed — one latest TERMINOLOGY.md#63
LukasWodka merged 2 commits into
developfrom
docs/terminology-retire-seed

Conversation

@LukasWodka

@LukasWodkaLukasWodka 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
Docs-only replacement of a terminology reference file; no product code or infrastructure behavior changes.

Overview
Replaces the 40-line develop seed with the 184-line v2 so develop and main share one terminology source and stop disagreeing on terms like workspace vs secure environment.

The updated TERMINOLOGY.md is framed as authoritative (skills must reference it, not redefine terms). It expands the old single “core terms” table into numbered sections: core product (secure environment decided 2026-07-12), people (collaborators over contributor/vendor), task taxonomy (16 tasks + per-task CSV/layout tables), training/models/FL, brand, CLI verb/flag vocabulary, engineering-internal naming, casing, a words to retire list tied to live code/UI drift, and refreshed open questions.

No runtime or API changes—documentation alignment only.

Reviewed by Cursor Bugbot for commit 2b98b30. 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>
Comment threadTERMINOLOGY.md Outdated
Comment threadTERMINOLOGY.md Outdated
…o secure environment only
Bugbot findings on #63:
- Section 9 still told people to keep the retired tracebloc-client repo
name; the repo is already renamed to tracebloc-engine — record it as
resolved.
- 'Words to retire' offered 'client' as a replacement for edge/edge
device; the decided user-facing term is secure environment — client
stays FL-technical only, never UI copy.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@LukasWodka

Copy link
Copy Markdown
ContributorAuthor

bugbot run

@cursorcursorBot 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.

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

Reviewed by Cursor Bugbot for commit 2b98b30. Configure here.

@LukasWodka
LukasWodka merged commit 7dbdd5d into developJul 23, 2026
6 checks passed
@LukasWodka
LukasWodka deleted the docs/terminology-retire-seed branch August 14, 2026 13:54
Sign up for freeto 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.

2 participants

@LukasWodka@divyasinghds