continued documentation; added json