Explain how the hidden fields option works

Make it clear what's happening to get the hidden fields exposed to the
toJSON methods of the popolo schemas.
Document how the models module works

Explain what's happening in this relatively short piece of code.
Refactor filter to be a simple function

We no longer need this to be a class, so simply use a function.