docs(cli): distinguish /clear from /new in CLI reference#1335
Open
factory-arman wants to merge 1 commit into
Open
docs(cli): distinguish /clear from /new in CLI reference#1335factory-arman wants to merge 1 commit into
factory-arman wants to merge 1 commit into
Conversation
/clear no longer resets the session: it preserves the current model and autonomy while wiping context, and /new is the command that resets to defaults. Update the EN and JP slash-command tables, which still called /clear an alias for /new, using the strings the CLI shows in its slash menu. Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
Contributor
|
Droid finished @factory-arman's task —— View job Phase 2 ValidationStatus: approved LGTM, this docs-only update correctly distinguishes |
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
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.
Description
What
The CLI reference still described
/clearas "Start a new session (alias for/new)". The two commands are no longer aliases.Why
/clearnow preserves the session's current model and autonomy while wiping conversation context, and/newis the command that resets model and autonomy to defaults. Readers of the reference would pick the wrong command for a mid-task context reset.How
This PR updates the
/clearand/newrows in the slash-command tables in both locales, using the exact descriptions the CLI shows in its slash menu so the docs and the TUI agree./clear/new)/newReviewer Guide
Diff shape: 100% documentation; four table rows across two localized files. No prose or structural changes.
Review depth: Skim — verify the two descriptions match the CLI slash menu in each locale.
Read order:
docs/reference/cli-reference.mdx— English slash-command table.docs/jp/reference/cli-reference.mdx— Japanese equivalents.Out of Scope
docs/changelog/release-notes.mdxalready carries the fix under July 14 /v0.172.0("/clearpreserves model"), so no changelog entry is added.docs/reference/hooks-reference.mdxstays accurate: both commands still create a new session under the hood, so theSessionStartclearmatcher and theSessionEndclearreason are unaffected.Risk & Impact
Low risk. Documentation-only; no CLI behavior, configuration, or generated artifacts change.
Verification
Behavior verified. Re-grepped
/clearacrossdocs/and confirmed no remaining "alias for/new" claims in either locale.Formatting. Checked table column alignment: English rows stay at 98 characters, Japanese rows at 109 east-asian display width, matching the surrounding rows.
Standard validators. No formatter, linter, typecheck, or test configuration exists in this docs-only repository;
git diff --checkpasses.