make reference doc aware of a 'references.json' file
tidy up
updated docs to help tern determine what objects are returned