Skip to content

Plainer wording in the CAIL Pi guide - #119

Merged
szweibel merged 1 commit into
mainfrom
cail-pi-guide-plain
Oct 14, 2026
Merged

szweibel merged 1 commit into
mainfrom
cail-pi-guide-plain

Conversation

@szweibel

Copy link
Copy Markdown
Collaborator

Wording-only revision of /docs/cail-pi, following the plain-writing guidance. Commands, steps and section structure are unchanged.

  • Sign in: "Working on another computer over SSH?" and "Prefer an API key?" become plain "If…" and "To use…" sentences. The "no default model" note now says the message can be ignored.
  • Install: "type n, because you'll run the next command in the terminal" replaces the "in the terminal, not inside Pi" contrast.
  • Before you start: the colon list becomes a sentence.
  • Add web search: "If you already have them, skip this step" moves ahead of the commands.
  • What it is: says the Windows setting makes Pi run commands in PowerShell.
  • Troubleshooting: says Pi runs full screen by default, and "For most problems, start by typing /cail" replaces two short sentences.
  • Privacy: the key-replacement sentences are combined.

bun run check passes locally, and a prose-lint pass on the page text returned no findings.

🤖 Generated with Claude Code

Replaces the two question openers in Sign in with plain conditionals,
drops the paired contrast and colon list in Install and Before you
start, moves "skip this step" ahead of the web-search commands, and
says what the Windows PowerShell setting and the full-screen default do.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@szweibel
szweibel merged commit 863feab into main Oct 14, 2026
4 checks passed
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