docs: document evolving specs in existing projects#2902
Conversation
|
Thanks for tackling this — the gap you're addressing is real, and the step-by-step workflow is useful. Since this PR was opened, #2856 landed on Requested changes:
The scope stays docs-only and the core content you wrote (the step-by-step workflow) remains — it just gets framed per-model so readers with different conventions get tailored guidance. |
73aa021 to
15c46be
Compare
|
Thanks for the detailed review. I've updated the PR to build on the spec persistence models and moved the brownfield guidance into |
Description
Closes #916.
Documents how existing projects can evolve specs over time using the persistence models introduced in the Spec Persistence Models guide. The update moves the brownfield workflow into a dedicated Evolving Specs guide and links to it from the README and SDD concepts page.
Scope:
docs/guides/evolving-specs.mdwith guidance for flow-forward, living spec, and flow-back workflows.Non-goals:
specify updatecommand.Testing
git diff --checkpython -m json.tool docs/docfx.jsondocs/toc.ymland checked updated local docs links/anchors