[Bug 28613] New: Rearrange and polish Messages interface

[bugzilla-daemon at freedesktop.org]

https://bugs.freedesktop.org/show_bug.cgi?id=28613

           Summary: Rearrange and polish Messages interface
           Product: Telepathy
           Version: git master
          Platform: Other
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: medium
         Component: tp-spec
        AssignedTo: telepathy-bugs at lists.freedesktop.org
        ReportedBy: will.thompson at collabora.co.uk
         QAContact: telepathy-bugs at lists.freedesktop.org


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

-- 
Configure bugmail: https://bugs.freedesktop.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.
You are the assignee for the bug.