go/docs
Snider 59dcbc2a31 feat(rfc): resolve ALL 16 known issues
Pass one complete. All 16 issues now have dispositions:

Resolved (design decisions):
- 1: Naming convention — CamelCase=primitive, UPPERCASE=sugar
- 5: RegisterAction location → solved by Issue 16 split
- 6: serviceRegistry → exported via Registry[T] (Section 20)
- 8: NewRuntime → NOT legacy, it's GUI bridge. Update factory signature.
- 9: CommandLifecycle → three-layer CLI (Cli/cli/go-process)
- 10: Array[T] → guardrail primitive, keep
- 11: ConfigVar[T] → promote to documented primitive
- 12: Ipc → owns Action registry, reads from Registry[T]
- 16: task.go → splits into ipc.go + action.go

Resolved (mechanical fixes):
- 2: MustServiceFor → keep, document startup-only usage
- 3: Embed() → remove (dead code)
- 4: Logging → document boundary (global=bootstrap, Core=runtime)
- 13: Lock allocation → use Registry[T], cache Lock struct
- 14: Startables/Stoppables → return []*Service directly
- 15: Stale comment → fix to match *Core return

Blocked (planned):
- 7: c.Process() → spec'd in Section 17, needs go-process v0.7.0

Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-25 12:25:59 +00:00
..
pkg docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
plans docs: remove implemented plans, annotate partial ones 2026-03-14 08:09:20 +00:00
commands.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
configuration.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
errors.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
getting-started.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
index.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
lifecycle.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
messaging.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
primitives.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
RFC.md feat(rfc): resolve ALL 16 known issues 2026-03-25 12:25:59 +00:00
services.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
subsystems.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
testing.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00