If you're making software for actual end-users, your point has merit. If you are creating a library for programmers to import into their own projects, nope, sor

If you're making software for actual end-users, your point has merit. If you are creating a library for programmers to import into their own projects, nope, sorry, RTFM (at least the first part of it) or get lost.