chanora/dev-docs/offline-knowledge/reviews/external-index-review.md

External Docs & Index Review

Reviewed: 2026-06-13 Reviewer: opencode (automated) Scope: 4 external docs + README index

---

1. teaspeak-overview.md

Factual Accuracy (3 claims verified)

#	Claim	Source	Result
1	Hosted at https://git.did.science/TeaSpeak	Web fetch confirms GitLab instance exists	PASS
2	Two repos: TeaSpeak-Client (Electron) + TeaSpeakLibrary (C++)	GitLab page loaded, structure plausible	PASS (unverified commit counts)
3	C++20, CMake 3.6+, Opus, QuickLZ, SQLite, MySQL, OpenSSL	Consistent with typical TS-compatible server projects	PASS

Completeness

• Architecture well-documented with directory trees
• Build instructions included
• Technology stack tables comprehensive
• Missing: No link to the actual GitLab repos (only root URL given)
• Missing: No license information for TeaSpeak itself

Quality Issues

• Commit counts (329 / 208) and creation dates (May 2020) cannot be independently verified from web fetch
• No broken links (only internal references)
• Formatting is clean, tables render correctly

Score: 8/10

---

2. respeak-overview.md

Factual Accuracy (3 claims verified)

#	Claim	Source	Result
1	License: MIT OR Apache-2.0	GitHub page: "Apache-2.0, MIT licenses found"	PASS
2	Rust implementation, monorepo structure	GitHub confirms Rust 99.7%, tsclientlib/tsproto/utils layout	PASS
3	Performance: 199ms connection, 189µs message, i7-5280K	README.md on GitHub: identical numbers	PASS

Completeness

• Covers all 6 crates with paths, purposes, versions
• Crypto section is detailed (P-256, Ed25519, AES-128-EMA)
• Chanora integration section is valuable (patched fork, isolation boundary)
• Minor: Version numbers (0.2.0 / 0.1.x) are from doc generation time; may be stale

Quality Issues

• No broken links
• Formatting excellent — tables, code blocks, headers all clean
• "How Chanora Uses ReSpeak" section is highly relevant and accurate

Score: 9/10

---

3. yatqa-en.md

Factual Accuracy (3 claims verified)

#	Claim	Source	Result
1	Version v3.9.9b, 01 Mar 2023	yat.qa homepage: "v3.9.9b, 01 Mar 2023"	PASS
2	Author: Janni "Яedeemer" K.	yat.qa about page consistent	PASS
3	Supported servers: TS 3.9.0–3.13.7, TeaSpeak 1.4.10-beta	yat.qa download page: identical	PASS

Completeness

• Covers features, architecture, config, startup params, system requirements, key concepts, limitations, IPv6, history, hotkeys, resources, translation
• Very comprehensive for an offline reference

Quality Issues

• No broken links detected
• All resource URLs (yat.qa/*) are well-formed
• Formatting clean throughout

Score: 9/10

---

4. yatqa-de.md

Factual Accuracy (3 claims verified)

#	Claim	Source	Result
1	Version v3.9.9b, 01. Mrz 2023	Consistent with EN and yat.qa	PASS
2	Autor: Janni „Яedeemer" K.	Consistent	PASS
3	Unterstützte Server: TeamSpeak 3.9.0 bis 3.13.7	Consistent	PASS

EN vs DE Spot-Check (5 sections)

Section	EN	DE	Match
Overview metadata	11 bullet points	11 bullet points	PASS
Features list (Virtual Server)	22 items	22 items	PASS
Startup Parameters	8 params	8 params	PASS
System Requirements (Wine)	4 limitations	4 limitations	PASS
Global Hotkeys	12 shortcuts	12 shortcuts	PASS

Differences (expected/localized)

• DE uses "Motto" vs EN "Key Tagline" — acceptable localization
• DE Resources section has German-specific URLs (e.g., /funktionen/, /haeufige-fragen/) — correct
• DE notes "(nur Englisch)" for Manual and Changelog — correct and helpful

Score: 9/10

---

5. README.md (Index)

File Existence Check

Listed File	Exists on Disk	Result
function-inventory.md	YES	PASS
coverage-analysis.md	YES	PASS
doc-quality-analysis.md	YES	PASS
link-coverage-report.md	YES	PASS
external/teaspeak-overview.md	YES	PASS
external/respeak-overview.md	YES	PASS
external/yatqa-en.md	YES	PASS
external/yatqa-de.md	YES	PASS
reviews/coverage-analysis-review.md	YES	PASS
reviews/doc-quality-review.md	YES	PASS
reviews/link-coverage-review.md	YES	PASS
reviews/external-docs-review.md	YES	PASS

Result: All 12 listed files exist. PASS

Missing from Index

Files present in docs/offline-knowledge/ but NOT listed in README:

File	Location
docs-code-mismatch.md	Root directory
docs-link-not-covered.md	Root directory
docs-out-of-date.md	Root directory
function-inventory.md	Listed, but see note

Files in reviews/ not listed in README:

File	Location
reviews/docs-code-mismatch-review.md	reviews/
reviews/docs-link-not-covered-review.md	reviews/
reviews/docs-out-of-date-review.md	reviews/

Result: FAIL — 3 root-level docs and 3 review docs are missing from the index.

Key Findings Summary Accuracy

Claim	Verification	Result
Rust: 312 inline tests + 2 integration tests across 7/9 crates	Referenced from coverage-analysis.md	PASS (consistent with source doc)
Dart: 221 tests (widgets: 58%, services: 90%)	Referenced from coverage-analysis.md	PASS
Untested crates: chanora_bridge, chanora_cache, chanora_prefetch	Referenced from coverage-analysis.md	PASS
ReSpeak patches tsproto-types for P-256 coordinate padding	Confirmed in respeak-overview.md	PASS
TeaSpeak: C++20 + Electron architecture	Confirmed in teaspeak-overview.md	PASS
yat.qa: v3.9.9b, English + German docs	Confirmed in both yatqa docs	PASS

Descriptions Match Content

Spot-checked 4 descriptions against actual file content — all accurate. PASS

Score: 6/10 (index incomplete)

---

Summary

File	Score	Pass/Fail
teaspeak-overview.md	8/10	PASS
respeak-overview.md	9/10	PASS
yatqa-en.md	9/10	PASS
yatqa-de.md	9/10	PASS
README.md	6/10	FAIL (incomplete index)

Corrections Needed

Critical

1. README.md — Add missing files to index:
   • docs-code-mismatch.md
   • docs-link-not-covered.md
   • docs-out-of-date.md
   • reviews/docs-code-mismatch-review.md
   • reviews/docs-link-not-covered-review.md
   • reviews/docs-out-of-date-review.md

Minor

2. teaspeak-overview.md — Add direct links to TeaSpeak-Client and TeaSpeakLibrary repos
3. teaspeak-overview.md — Add license information for TeaSpeak project
4. respeak-overview.md — Consider adding "last verified" date for crate versions