From Dev.to
Keeping Docs in Sync: Regenerating on Every Spec Change
Quick answer: Documentation stays accurate only when regeneration is wired into the same pipeline that changes the spec, not when it depends on a person remembering to rebuild the docs after a merge....