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.