added the ability to update the auto_publish flag for repository distributors
Added documentation for updating distributors
fixed some documentation formatting
fixed some more comments based on PR review
Merge pull request #554 from pulp/jcline-970785

Added the ability to update the auto_publish flag for repository distributors