added documentation of output json and assertions