Reword credential docs for consistency and spelling

1 files changed, 9 insertions, 5 deletions

diff --git a/man/gemfile.5.ronn b/man/gemfile.5.ronn
index 6161b12e84..0187329730 100644
--- a/man/gemfile.5.ronn
+++ b/man/gemfile.5.ronn
@@ -26,18 +26,22 @@ might contain the gems listed in the `Gemfile`.
 Each of these _source_s `MUST` be a valid Rubygems repository. Sources are
 checked for gems following the heuristics described in [SOURCE PRIORITY][].
 
-### PRIVATE REPOSITORIES
+### CREDENTIALS (#credentials)
 
-To access private repositories you can use `bundle config` to set user and
-password on a per source basis.
+Some gem sources require a username and password. Use `bundle config` to set
+the username and password for any sources that need it. The command must be run
+once on each computer that will install the Gemfile, but this keeps the
+credentials from being stored in plain text in version control.
 
     bundle config https://gems.example.com/ user:password
 
-As alternative you can provide credentials directly in the source URI.
+For some sources, like a company Gemfury account, it may be easier to simply
+include the credentials in the Gemfile as part of the source URL.
 
     source "https://user:password@gems.example.com"
 
-Credentials provided in the source URI will take presedence.
+Credentials in the source URL will take precedence over credentials set using
+`config`.
 
 ## RUBY (#ruby)