Update package provider writing guidelines

Included a paragraph about available_version that reflects the changes
made to implement #3687.
Merge pull request #4031 from terminalmage/docs

Update package provider writing guidelines