Interesting point. Generally, in my experience, specifications, that is the documents produced prior to building a system are replaced by the documentation that

Interesting point. Generally, in my experience, specifications, that is the documents produced prior to building a system are replaced by the documentation that’s created after the system is built. I have seen some projects try to keep the specs updated, even fewer that try to keep the specs/build/docs in sync via tagging and unique IDs. If the specs were within this framework, my guess is they would go under reference; for example, an API spec would easily be kept in sync and would naturally go under the reference section. In fact, the example given is for a CLI: https://docs.divio.com/en/latest/reference/divio-cli/ https://docs.divio.com/en/latest/reference/divio-cli/