Code doesn't explain best practices, architectural concerns, and so on. Best combo? Docs + code.
Then you can ruthlessly prune the docs folder on PR review and regular passes when e.g. claude really wants to write a novel about the glorious intricacies of bugs it's solved.