caught one more JSON breaking exception
doc bug
copious documentation added
caught bug with returning [] vs promise([])
incremental; added one test, added placeholders