docs: rewrite README in Simplified Technical English

[JarbasAl]

Rewrites README.md for clarity: plain factual intro, a dedicated License section, and a Related Projects section linking sibling OVOS repos. Adds the docs navigation footer to the four docs/*.md pages (index.md stays the map, exempt from the footer). No facts, features, or config keys were added or removed.

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

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 6dc5011c-bcdf-453f-8bca-eced81f24836

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

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]

At your service! I've gathered all the check results for you. 🫡

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

🏷️ Release Preview

Evaluating the overall quality of the next release. ✨

Current: 2.1.1a2 → Next: 2.1.1a3

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: 2.1.1a3

Channel	Status	Note	Current Constraint
Stable	❌	Too new (must be <0.5.0)	ovos-audio>=0.4.0,<0.5.0
Testing	❌	Too new (must be <2.0.0)	ovos-audio>=1.1.0,<2.0.0
Alpha	✅	Compatible	ovos-audio>=2.1.1a2

🔒 Security (pip-audit)

Checking for any potential privacy concerns. 🕶️

✅ No known vulnerabilities found (66 packages scanned).

🔍 Lint

Evaluating the overall quality of your PR. ✨

❌ ruff: issues found — see job log

📊 Coverage

Ensuring no code path is left in the shadows. 🌑

✅ 98.2% total coverage

Per-file coverage (9 files)

File	Coverage	Missing lines
ovos_audio/__main__.py	93.8%	1
ovos_audio/audio.py	95.3%	16
ovos_audio/__init__.py	100.0%	0
ovos_audio/playback.py	100.0%	0
ovos_audio/service.py	100.0%	0
ovos_audio/transformers.py	100.0%	0
ovos_audio/tts.py	100.0%	0
ovos_audio/utils.py	100.0%	0
ovos_audio/version.py	100.0%	0

Full report: download the coverage-report artifact.

⚖️ License Check

Checking the paperwork! Everything seems in order. 📂

✅ No license violations found.

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

📋 Repo Health

Ensuring the repository stays up to date. 🔄

✅ All required files present.

Latest Version: 2.1.1a2

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

🔌 Skill Tests (ovoscope)

Ensuring the skill's dialogs are as clear as day. ☀️

✅ 57/57 passed

✅ TestAudioCaptureSequence — 1/1
✅ TestAudioCaptureSequencePlayStop — 1/1
✅ TestAudioDuckingLowersVolume — 1/1
✅ TestAudioDuckingNoCurrentOnRecord — 1/1
✅ TestAudioDuckingOnRecord — 1/1
✅ TestAudioDuckingRestoresVolume — 1/1
✅ TestB64Audio — 1/1
✅ TestB64DualNamespaceDelivery — 6/6
✅ TestDefaultSessionAccepted — 1/1
✅ TestGetLanguagesTts — 1/1
✅ TestGetTrackLength — 1/1
✅ TestGetTrackPosition — 1/1
✅ TestInstantPlayBinaryData — 1/1
✅ TestInstantPlayWav — 1/1
✅ TestListBackends — 1/1
✅ TestMultipleSpeaks — 1/1
✅ TestMultipleSpeaksCaptureAllEvents — 1/1
✅ TestNoSpuriousEventsAfterShutdown — 1/1
✅ TestOcpFlagIntegration — 1/1
✅ TestOpmG2pQuery — 1/1
✅ TestOpmTtsQuery — 1/1
✅ TestPlayHttpTrack — 1/1
✅ TestPlayPauseResume — 1/1
✅ TestPlaybackStopDualSubscription — 2/2
✅ TestPlaylistNextPrev — 1/1
✅ TestQueueSound — 1/1
✅ TestQueueSoundWithBinaryData — 1/1
✅ TestQueueTracks — 1/1
✅ TestRestoreVolumeOnHandled — 1/1
✅ TestRestoreVolumeOnHandledWhileSpeaking — 1/1
✅ TestSeekBackward — 1/1
✅ TestSeekForward — 1/1
✅ TestSessionValidation — 1/1
✅ TestSetTrackPosition — 1/1
✅ TestSpeakAfterStop — 1/1
✅ TestSpeakBasic — 1/1
✅ TestSpeakExpectResponse — 1/1
✅ TestSpeakNonDefaultSessionRejected — 1/1
✅ TestSpeakResetMockTts — 1/1
✅ TestSpeakSpecTopic — 1/1
✅ TestSpeakStatus — 1/1
✅ TestSpeakStatusNotSpeaking — 1/1
✅ TestSpeakWithIdentContext — 1/1
✅ TestStop — 1/1
✅ TestStopBeforeGuardIsIgnored — 1/1
✅ TestStopTTS — 1/1
✅ TestTrackEndCallbackEmission — 1/1
✅ TestTrackInfo — 1/1
✅ TestTrackStartCallbackEmission — 1/1
✅ TestTtsStopDualTopic — 2/2

🚌 Bus Coverage

How deep does the message bus rabbit hole go? 🐇

⚠️ Bus coverage report unavailable — check the job log.

🔗 Downstream Dependents

Another check completed successfully! 🏁

No dependents found for ovos-audio

🔨 Build Tests

Testing the recipe! Did the build turn out okay? 👨‍🍳

✅ All versions pass

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

---

May the tests be ever in your favor! 🏹