Documentation edits

Edit the documentation for minor grammar, idiomatic usage, and sentence construction issues.  Overall the documentation is great;  this is just cleaning up some places that sound a little odd.

There are some notes left in the documentation delimited by [bwb: ...] where I made a larger-than-usual change or I thought needed attention from someone more familiar with the codebase than I am.



On Nov 4, 2014, at 2:42 AM, Christian Kaps <notifications@github.com> wrote:

> In docs/how-it-works/authenticator.rst:
> 
> >  request to a :ref:`Silhouette action <silhouette_actions>`. If sliding window expiration
> > -is disabled then the authenticator will not be updated.
> > +is disabled, then the authenticator will not be touched.
> Whit this, I mean that the authenticator will not be updated by the update method if sliding window expiration is disabled. As example: the JWT authenticator does create a new token on every update if it was previously touched. If it wasn't touched then it doesn't create a new token because update will not be executed.
> 
Does this capture the idea?

For authenticators that use a sliding window expiration, calling ``touch`` causes
the last used time to be updated upon each request to a :ref:`Silhouette action 
<silhouette_actions>`. Such updates are not needed for authenticators that do not use
a sliding window expiration.



---------------------------------------------
Byron Weber Becker
School of Computer Science
University of Waterloo, Waterloo, Ontario  N2L 3G1
Email: bwbecker@uwaterloo.ca
Phone:  519-888-4567 x38331
Fax:  519-888-4380 (include my email on cover page)

Advising FAQ:  www.cs.uwaterloo.ca/current/faq