[kodah]

Words do matter, as do the concepts behind them. We've been generating documentation through code for a long time. Go has an implementation of this and OpenAPI does as well. Docs as code seems to endear adjacency to code. Version controlling and linting things in a pipeline is a useful concept, though not particularly novel as far as static site generators go. Maybe "version controlled docs" would be a better term.

[chillbill]

Words do matter indeed, and your usage of them is wrong.

What you described is docs _in_ code. The title is docs _as_ code, which means exactly as what the article describes, treating it as if it is code in pursuit of maintainability.

[notorandit]

Totally agree. This code-mania needs to get to an end.

Of course you can start calling your mouse "a cat", your car "a mobility device" and yourself a genius. But reality won't easily follow.