Lukewarm take:
If you have to keep adding docs for people to understand how to use your APIs, it's probably because your APIs suck
Especially if it's because people keep incorrectly assuming what your APIs do, and the assumed behavior is actually reasonable
i miss the old react, straight from facebook react
componentDidMount react, with this.state.count react
i hate the new react, triangle crew react
be needing "use" react, server side views react
i miss the sweet react, boot up from vite react
i gotta say, at that time, i'd like to tweet react
see i invented react, it wasn't any react
and now i look and look around and there's so many reacts
i used to love react, i used to love react
i even had redux in it, i thought i was react
what if react made an app about about react
called it "i miss the old react"? man, that'd be so react
that's all it was react, we still love react
and i love you like theo loves react
The growing complexity of software is not the worst thing. In fact it is completely natural, just as the growing entropy of a system. The worst thing is the people believing it is absolutely necessary and not only refusing to fight it, but actually defending it.