better json fields, added first documentation