[Bug 28719] New: Improve documentation of Stream.Endpoint

[bugzilla-daemon at freedesktop.org]

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

           Summary: Improve documentation of Stream.Endpoint
           Product: Telepathy
           Version: unspecified
          Platform: Other
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: medium
         Component: tp-spec
        AssignedTo: telepathy-bugs at lists.freedesktop.org
        ReportedBy: sjoerd at luon.net
         QAContact: telepathy-bugs at lists.freedesktop.org


>From #24936

Stream.Endpoint:

* nothing is documented or cross-referenced yet

* SelectedCandidate / CandidateSelected are another "which is which?"
property/signal pair

* it's not clear why Transport is needed, since it seems to duplicate
Stream.I.Media.Transport

>From IRC discussion:

17:13 < sjoerd> SIP has a fallback path from ice to raw-udp
17:13 < sjoerd> You send your offer with one raw-udp candidate and a set of ice 
                ones
17:13 < sjoerd> if the other side doesn't support raw-udp it'll accept with one 
                raw-udp candidate
17:14 < sjoerd> and you'll actually use raw-udp
17:14 < sjoerd> I'm vaguely pondering of having the STream transport stay ice 
                in that case, but have the endpoint say raw-udp
17:14 < sjoerd> not entirely sure about it yet
17:15 < sjoerd> We're going to require that every streaming implemetation can 
                do the fallback to raw-udp and always give you one candidate to 
                use as the raw-udp candidte as well

That last point should be written into the spec, if it's what we mean.

-- 
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.