update comments
document structure of the JSON dataset