[jrockway]

To me documentation is largely a lost cause, it starts out behind the code and stays that way forever, because the machine can't execute the documentation. Yes, the human maintaining the code is more important than the computer running the code, but when you have an infinite number of tasks to get done, what the computer accepts is a pretty good stopping point for most people.

Personally I see a lot of value in documentation (that's how I learned the basics of programming and the systems I use), but since it's always out of date and wrong, I tend to undervalue it. Maybe that's a mistake.

[robertlagrant]

This is why I like Flask+Connexion or FastAPI - endpoints are generated from Swagger docs or vice versa.