Clarify rules for package name in documentation

Nowhere in the documentation does it say that the only valid package names
are ones that match (excuse my abuse of regex to explain this):

^[A-Za-z][A-Za-z0-9_]

This change makes clear the rules followed by the PackageParser