Donald, I've added this to the list at
(the comments from Marcus and Paul were already noted).

one other thing Donald and I discussed was being clear what was compatible with pkg_resources.
my understanding is that *only* local versions are incompatible, in that they don't sort correctly relative to public versions.
I'd like to see mention of that somewhere.