Do you think it might help to have a sort of definition of terms up front?  In particular, the term "package" is extremely overloaded.  I try to use it only to refer to the Python package itself, while using "distribution" to refer to the entire project, though sometimes I use "project" for that purpose too.

It's important to be clear that the distribution might be named "astropy-helpers", though the package would have to be "astropy_helpers".