As a new or existing user of apiman, it would be super useful to have some detailed docs on the project's policy plugins. Something like ...

• Policies
  • List of each supported policy
    • identify plugin
    • describe policy (what it does)
    • discuss relevant config details (how do I configure it)
  • How to add policies
  • Developing custom policies