http://simonwillison.net/2025-05-22T01:55:31+00:00Simon Willison2025-05-22T01:55:31+00:002025-05-22T01:55:31+00:00https://simonwillison.net/2025/May/22/no-docs-no-bugs/#atom-tag

<p><strong>If your library doesn't have any documentation, it can't have any bugs.</strong></p> <p>Documentation specifies what your code is supposed to do. Your tests specify what it actually does.</p> <p>Bugs exist when your test-enforced implementation fails to match the behavior described in your documentation. Without documentation a bug is just undefined behavior.</p> <p>If you aim to follow <a href="https://semver.org/">semantic versioning</a> you bump your major version when you release a backwards incompatible change. Such changes cannot exist if your code is not comprehensively documented!</p> <p><small>Inspired by a half-remembered conversation I had with <a href="https://movieos.org/">Tom Insam</a> many years ago. </small></p> <p>Tags: <a href="https://simonwillison.net/tags/documentation">documentation</a>, <a href="https://simonwillison.net/tags/semantic-versioning">semantic-versioning</a>, <a href="https://simonwillison.net/tags/testing">testing</a></p>

2021-08-06T16:17:31+00:002021-08-06T16:17:31+00:00https://simonwillison.net/2021/Aug/6/will-mcgugan/#atom-tag

<blockquote cite="https://twitter.com/willmcgugan/status/1423678688802058244"><p>The thing about semver major version numbers are that they don't mean new stuff, they're a permanent reminder of how many times you got the API wrong. Semver doesn't mean MAJOR.MINOR.PATCH, it means FAILS.FEATURES.BUGS</p></blockquote> <p class="cite">&mdash; <a href="https://twitter.com/willmcgugan/status/1423678688802058244">Will McGugan</a></p> <p>Tags: <a href="https://simonwillison.net/tags/semantic-versioning">semantic-versioning</a>, <a href="https://simonwillison.net/tags/versioning">versioning</a>, <a href="https://simonwillison.net/tags/will-mcgugan">will-mcgugan</a></p>

2019-05-25T01:20:37+00:002019-05-25T01:20:37+00:00https://simonwillison.net/2019/May/25/sqlite-utils-1/#atom-tag

<p><strong><a href="https://sqlite-utils.readthedocs.io/en/latest/changelog.html#v1-0">sqlite-utils 1.0</a></strong></p> I just released sqlite-utils 1.0, with a couple of handy new features over 0.14: it can now automatically add columns to a database table if you attempt to insert data which doesn’t quite fit (using alter=True in the Python API or the --alter option to the “sqlite-utils insert” command). It also has the ability to output nested JSON column values on the command-line using the new --json-cols option. This is the first project I’ve marked as a 1.0 release in a very long time—I’ll be sticking to semver for this project from now on, bumping the major version only in the case of a backwards incompatible change. <p>Tags: <a href="https://simonwillison.net/tags/projects">projects</a>, <a href="https://simonwillison.net/tags/semantic-versioning">semantic-versioning</a>, <a href="https://simonwillison.net/tags/sqlite">sqlite</a>, <a href="https://simonwillison.net/tags/versioning">versioning</a>, <a href="https://simonwillison.net/tags/sqlite-utils">sqlite-utils</a></p>

2009-12-15T21:53:18+00:002009-12-15T21:53:18+00:00https://simonwillison.net/2009/Dec/15/semantic/#atom-tag

<p><strong><a href="http://semver.org/">Semantic Versioning</a></strong></p> Tom Preston-Werner provides a name, specification and URL describing the relatively widely used Major.Minor.Patch versioning system. This is really useful—by giving something a name and a spec, people can say “this project uses semantic versioning” and skip having to explain their backwards compatibility policy in full. <p>Tags: <a href="https://simonwillison.net/tags/naming-things">naming-things</a>, <a href="https://simonwillison.net/tags/open-source">open-source</a>, <a href="https://simonwillison.net/tags/semantic-versioning">semantic-versioning</a>, <a href="https://simonwillison.net/tags/software">software</a>, <a href="https://simonwillison.net/tags/tom-preston-werner">tom-preston-werner</a>, <a href="https://simonwillison.net/tags/versioning">versioning</a></p>