Explain the behavior of the policy attribute
Whitespace fixes
Added an example
Merge pull request #559 from lra/explain_policy

Explain the behavior of the policy attribute