Update package provider writing guidelines

Included a paragraph about available_version that reflects the changes
made to implement #3687.