I’ve got the gist of the semantic versioning specification . My question arises in regard to this:
Software using Semantic Versioning MUST declare a public API. This API could be declared in the code itself or exist strictly in documentation. However it is done, it should be precise and comprehensive.
An API declared in code is straight forward. Please help me picture an API that exists strictly in documentation. Can this mean any documentation that explains how to use the software and as long as changes don’t contradict existing documentation the major version isn’t incremented? Or am I interpreting it all wrong?