3 ms·
Something that here a lot here is having comprehensive, trustworthy documentation. This gives you the moral high ground to adopt semantic versioning: the corre
by simonw 5y ago
Something that here a lot here is having comprehensive, trustworthy documentation.
This gives you the moral high ground to adopt semantic versioning: the correct behavior is the documented behavior. If someone has code that relies on an undocumented method or undocumented behavior, it's fair game to break that with only a minor version bump.
If your documentation isn't any good, SemVer is almost a fiction.
- jnxx 5y agoI second that. Also, semantic versioning requires documentation to give specific meaning to an interface.