expose and document readDeployments function
rename 'readDeployments' to 'deployments' for consistency
Merge pull request #29 from rstudio/feature/expose-read-deployments

Expose and document readDeployments function