documentation now in readme, and valid JSON!