[Telepathy] Change proposal to Connection.Interface.Capabilities

[Dafydd Harries]

Ar 20/09/2006 am 10:07, ysgrifennodd Daniel d'Andrada Tenório de Carvalho:
> So, Connection.Interface.Capabilities is on the "ease of use" side and 
> Connection.Interface.Presence is on the "correctness" side.
> 
> What side are we taking?

I think Telepathy design strives, above all, for conceptual integrity, and
that we try to make things as straightforward to implement as possible without
violating that.

I think you're right to worry about obviousness of API; if we can make it
harder for people to get it wrong, we should in general.

Rusty Ruseell has a talk a few years ago which contains some good advice on
API design, though its examples come mostly from kernel-land and therefore
might be a bit opaque:

http://ozlabs.org/~rusty/ols-2003-keynote/img39.html

While digging that up, I also found this, which seems very sensible:

http://lcsd05.cs.tamu.edu/slides/keynote.pdf

-- 
Dafydd