Hacker News Reader

I completely agree that documentation should be part of the CI/CD and that it should be part of the code.

The only way for documentation to be part of CI (IMO) is for missing documentation to cause failed builds. There are a few ways I could think of to enforce this but is there anything off the shelf that does this?

I've been doing this for nearly three years now - it works really well.

It's not particularly sophisticated - just some tests which introspect the code and then use dumb pattern matching against the documentation text to check that different concepts from the code are mentioned at least once in the docs: https://simonwillison.net/2018/Jul/28/documentation-unit-tes...

Are you the guy who wrote this? Would love to interview you for my podcast.

Reply on news.ycombinator.com