Fix for broken JSON tests

fixes #21 tests
Added extensibility mechanism

- to customize transforming the Documentation
- to customize the sorting of the Documented APIs and Operations

closes #31