An awful lot of the FOSS ecosystem needs to

1. touch grass,
2. get away from fellow techbros and meet real people in all our diversity,
3. learn good technical writing, and
4. put some effort into making their programs easy for ordinary, non-techbro users to intuit.

In short, get out and look back at it.

Examples of what not to do:
* Fail to make a command/program with the same name as the package.
* Fail to make that command either do the obvious thing or give useful help toward that end.