Docs from Code vs Docs from a Spec

Short answer: Docs from code infer the API from the implementation, which is convenient but couples the docs to the code's structure. Docs from a spec render a contract that is maintained independentl