docs: split user and maintainer docs, fix 100+ stale claims (#4807)

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>