docs: rewrite README in Simplified Technical English

[JarbasAl]

Rewrites the README and the docs/ pages for clarity: shorter sentences, active voice, no marketing wording, and no em dashes or semicolons. Adds a navigation footer to each docs/ page pointing to its neighbors and the docs index. Every fact, code block, and link is unchanged.

Rewritten by Claude Sonnet 5 using the ste-writing skill (authored and reviewed by Claude Fable 5); linted with ste_lint.py.

🤖 Generated with Claude Code

Summary by CodeRabbit

• Documentation
  • Clarified installation, quickstart steps, CLI behavior, operating modes, configuration, and troubleshooting guidance.
  • Improved explanations of architecture, accessibility, keyboard-only operation, satellite processing boundaries, and testing workflows.
  • Updated skill-testing guidance to highlight faster server-side feedback.
  • Added consistent navigation links across documentation pages.
  • Corrected wording, formatting, terminology, and minor spelling issues without changing commands or options.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 5a8dca15-fab9-4b67-8543-dcc4c57c0316

📥 Commits

Reviewing files that changed from the base of the PR and between d319ae9 and 02a0b2e.

📒 Files selected for processing (8)

• README.md
• docs/architecture.md
• docs/configuration.md
• docs/development.md
• docs/getting-started.md
• docs/index.md
• docs/troubleshooting.md
• docs/usage.md

---

📝 Walkthrough

Walkthrough

Documentation was revised across the README and guides to clarify CLI operation, setup, configuration, accessibility, testing, troubleshooting, and navigation. No functional code or public declarations changed.

Changes

Documentation update

Layer / File(s)	Summary
CLI orientation and onboarding README.md, docs/index.md, docs/getting-started.md	Clarifies keyboard-only operation, satellite boundaries, dependency setup, quickstart steps, and initial interaction.
Architecture, configuration, and usage guidance docs/architecture.md, docs/configuration.md, docs/usage.md	Clarifies client behavior, connection settings, skill testing, accessibility, and related navigation.
Development and troubleshooting documentation docs/development.md, docs/troubleshooting.md	Clarifies dependency configuration, end-to-end testing, versioning, connection troubleshooting, and navigation.

Estimated code review effort: 1 (Trivial) | ~5 minutes

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/ste-readme

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

Systems nominal. Checks complete. 🛸

I've aggregated the results of the automated checks for this PR below.

📋 Repo Health

Keeping the project in tip-top shape! 🏃

✅ All required files present.

Latest Version: 1.0.0a1

✅ hivemind_cli_terminal/version.py — Version file
✅ README.md — README
✅ LICENSE — License file
✅ pyproject.toml — pyproject.toml
⚠️ setup.py — setup.py
✅ CHANGELOG.md — Changelog
✅ hivemind_cli_terminal/version.py has valid version block markers

⚖️ License Check

Checking if the licenses are compatible with OVOS. 🧩

✅ No license violations found.

Policy: Apache 2.0 (universal donor). StrongCopyleft / NetworkCopyleft / WeakCopyleft / Other / Error categories fail. MPL allowed.

🔍 Lint

Here's the latest update on this check. 🗞️

❌ ruff: issues found — see job log

🏷️ Release Preview

I've checked the 'Platform Support' matrix. 💻

Current: 1.0.0a1 → Next: 1.0.0a2

Signal	Value
Label	(none)
PR title	docs: rewrite README in Simplified Technical English
Bump	alpha

✅ PR title follows conventional commit format.

---

🚀 Release Channel Compatibility

Predicted next version: 1.0.0a2

Channel	Status	Note	Current Constraint
Stable	⚪	Not in channel	-
Testing	⚪	Not in channel	-
Alpha	⚪	Not in channel	-

📊 Coverage

A comprehensive review of our code coverage. 📖

❌ 27.5% total coverage

Per-file coverage (3 files)

File	Coverage	Missing lines
hivemind_cli_terminal/__main__.py	0.0%	40
hivemind_cli_terminal/version.py	0.0%	5
hivemind_cli_terminal/__init__.py	46.9%	34

Full report: download the coverage-report artifact.

🔨 Build Tests

Testing the robustness of the build environment. 🏔️

✅ All versions pass

Python	Build	Install	Tests
3.10	✅	✅	✅
3.11	✅	✅	✅
3.12	✅	✅	✅
3.13	✅	✅	✅

---

Keeping the OVOS ecosystem thriving 🌿