README.md in prx_auth-rails-1.2.0 vs README.md in prx_auth-rails-1.3.0

@@ -1,8 +1,9 @@
 # PrxAuth::Rails
 
-Rails integration for next generation PRX Authorization system.
+Rails integration for next generation PRX Authorization system. This
+provides common OpenId authorization patterns used in PRX apps.
 
 ## Installation
 
 Add this line to your application's Gemfile:
 
@@ -12,31 +13,49 @@
 
     $ bundle
 
 ## Usage
 
-Installing the gem in a Rails project will automatically add the appropriate Rack middleware to your Rails application and add two methods to your controllers. These methods are:
+Installing the gem in a Rails project will automatically add the
+appropriate Rack middleware to your Rails application and add two
+methods to your controllers. These methods are:
 
-* `prx_auth_token`: returns a token (similar to PrxAuth::Token) which automatically namespaces queries. The main methods you will be interested in are `authorized?`, `globally_authorized?` and `resources`. More information can be found in PrxAuth.
+* `prx_auth_token`: returns a token (similar to PrxAuth::Token) which
+  automatically namespaces queries. The main methods you will be
+interested in are `authorized?`, `globally_authorized?` and `resources`.
+More information can be found in PrxAuth.
 
-* `prx_authenticated?`: returns whether or not this request includes a valid PrxAuth token.
+* `prx_authenticated?`: returns whether or not this request includes a
+  valid PrxAuth token.
 
+This will let set up the Rails app to be ready for HTTP requests
+associated with an OpenId access token.
+
 ### Configuration
 
-Generally, configuration is not required and the gem aims for great defaults, but you can override some settings if you need to change the default behavior.
+Generally, configuration is not required and the gem aims for great
+defaults, but you can override some settings if you need to change the
+default behavior.
 
-In your rails app, add a file to config/initializers called `prx_auth.rb`:
+If you're using the Rails server-side session flow, you must supply the
+client_id via configuration.
 
+In your rails app, add a file to config/initializers called
+`prx_auth.rb`:
+
 ```ruby
 PrxAuth::Rails.configure do |config|
 
   # enables automatic installation of token parser middleware
   config.install_middleware = false # default: true
 
   # automatically adds namespace to all scoped queries, e.g. .authorized?(:foo) will be treated
   # as .authorized?(:my_great_ns, :foo). Has no impact on unscoped queries.
   config.namespace = :my_great_ns   # default: derived from Rails::Application name.
                                     #          e.g. class Feeder < Rails::Application => :feeder
+
+  # Set up the PRX OpenID client_id if using the backend rails sessions flow.
+  config.client_id = '<some client id>'
 end
 ```
 
 ## Contributing