Change: Clarify documentation on permissive package_methods

Picking from master into 3.6.x branch
Merge pull request #344 from nickanderson/pick_permissive_doc_fix

Change: Clarify documentation on permissive package_methods