4 ms·
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
by kodah 3y ago
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 3y agoWords 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 3y agoTotally 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.