Move the JSON migration docs to documentation
Merge pull request #5 from piojo/master

Promote the JSON migration from review to documentation.