- improve the documentation
- more fixes to documentation
- reverted to old json grammar, still like it better than the new fancy syntax