My decision to use Telepathy (Python) to write an SIP client is on shaky grounds.
I'm running into snag after snag and it's affecting my confidence in using this framework for my project. Apart from the documentation problems (documentation should emphasize "how" to do things as opposed to explaining architectural designs and contain plenty examples), it seems as if some interfaces available in the documentation don't even work. See this bug for example. https://bugs.freedesktop.org/show_bug.cgi?id=35314 That bug was submitted 3 months ago and there has been no response, triage or confirmation of the bug from any developer. The bug is most likely a blocker on any Python project that wants to use Telepathy. This bug might also be of interest for whoever maintains telepathy farstream. https://bugs.freedesktop.org/show_bug.cgi?id=37941 The Python examples in the Developer's handbook use deprecated APIs which will inevitably confuse users new to the framework. To make matters worse, most of the Python examples don't even work. On the documentation, the emphasize should be on "how" to use an API. Each API should be accompanied with several examples specifying several use cases.Users should be able to read an API doc and know what it does, how, and when to use it. Unfortunately, that's not the case with Telepathy. I have to bounce from example code that I don't trust to work, to reading source code, to reading the spec, to trial and error hacking. Thus making my progress with framework very slow. QT does a fantastic job with their documentation it can be a source of inspiration for the Telepathy framework. Anyway, back to Telepathy Python. Is it still maintained? Is it wise for us to use it to build an SIP client or should I look elsewhere? Also are there any Free Software Python apps that have been written with Telepathy? Thanks _______________________________________________ telepathy mailing list [email protected] http://lists.freedesktop.org/mailman/listinfo/telepathy
