Writing

pkg.go.dev is excellent at being Go's package index. It is not your project's documentation site, and the Go community has accepted that split for too long.

The C++ ecosystem has spent twenty years trying to replace Doxygen. The escape was always inside the toolchain. Cut at the joint.

OpenAPI was designed to be portable. Most teams render it through a vendor that erases the portability.

Encyclopedia Britannica stopped printing in 2010. The same shift is happening to documentation now, with two audiences this time instead of one.