docs(terminology): secure environment (was workspace) + collaborators (was contributor)#62
Closed
LukasWodka wants to merge 1 commit into
Closed
docs(terminology): secure environment (was workspace) + collaborators (was contributor)#62LukasWodka wants to merge 1 commit into
LukasWodka wants to merge 1 commit into
Conversation
…(was contributor) Reverses the 2026-06-05 'workspace' decision per Lukas (2026-07-12): the on-prem environment is a 'secure environment' everywhere user-facing; the invited model builders are 'collaborators' (retires 'contributor'). Adds the tracebloc CLI + 'this machine' terms and 'push' to ingest's don't-use. Flags the propagation gap: the communication skill's Terminology Bible + website + decks still say workspace. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Contributor
Author
|
👋 Heads-up — Code review queue is at 53 / 30 Above the WIP limit. The team convention is to review existing PRs before opening new work. Open PRs currently in Code review (oldest first):
Pull from review before opening new work. (This is a nudge from the kanban WIP check, not a block.) |
Contributor
Author
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
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
Updates the terminology source of truth with two decisions made 2026-07-12 while we designed the installer + home-screen copy, plus the new CLI terms:
clientstill survives only in Client ID.the tracebloc CLI(thetracebloc/tbcommand);this machinefor the specific host in CLI/installer copy;pushadded toingest's don't-use list."secure environment" is not yet in the other terminology surfaces, and it actually reverses a brand rule. Before this is fully consistent, these need the same sweep (flagged in the doc + open question #1):
communicationskill's "Terminology Bible" — a second copy of these terms; still says workspace + contributors, and explicitly lists "don't say environment."So merging this makes
docs/TERMINOLOGY.mdcorrect, but the comms skill + marketing surfaces will disagree until swept.Why
Every screen we built this session (the status-aware home screen
cli#244, the installer run-through) uses "secure environment" and "collaborators". This aligns the source of truth with the shipped/locked copy.Test plan
Docs-only (a single markdown file). No code paths.
Note
Low Risk
Docs-only change to a single markdown file; no runtime behavior, though merging creates intentional terminology mismatch until other surfaces are updated.
Overview
Realigns
TERMINOLOGY.mdwith 2026-07-12 product copy: the on-prem install is now secure environment (retiring workspace, reversing the earlier workspace decision) and invited model builders are collaborators (retiring contributor). Client ID stays the only “client” noun.The core terms table gains the tracebloc CLI (
tracebloc/tb), this machine for host-specific CLI/installer wording, and push on the ingest don’t-use list; definitions and Online/Offline wording follow the new terms. Owner / “you” replaces workspace owner pending open question #2.A sync note and updated open questions call out that the communication skill Terminology Bible, website, decks, and app UI still use workspace/contributors until a follow-up sweep.
Reviewed by Cursor Bugbot for commit e93d0fe. Bugbot is set up for automated code reviews on this repo. Configure here.