* Part 1: Invites * Part 2: Knocks * Use correct schema and examples; Remind readers often about formats * changelogs * Add schema warning * Name the objects * Move changed-in and expand upon it * Rename the example * address review feedback