Entry points docs & cleanup

In wake of the changes I made I realized there were some things I didn't fix. There was some dead code hanging around, and the docs needed updating.
This doesn't make sense to me. what is plugin-distribution.tar.gz ?