readme: specify JSON options, flesh out details