The Messages interface is incredibly long. In particular, the Message_Part definition <http://telepathy.freedesktop.org/spec/Channel_Interface_Messages.html#Message_Part> is massive and hard to follow, with header and body key definitions (and then some more headers for delivery) interspersed with short paragraphs and long rationales and examples. So before I add any more to this interface, here's a branch which tidies it up. I split out the definitions of well-known message part keys into three simple-types, added a load of cross-referencing markup, and rephrased a bunch of the documentation. I think it's easier to follow now. http://people.freedesktop.org/~wjt/telepathy-spec-messages_lint/spec/Channel_Interface_Messages.html
I endorse this initiative. r+
Ta, merged to master. CCing Olivier, who was interested in taking a look from the POV of someone who recently implemented the messages interface.
Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.