[Tracker] Team conclusions on IRC, DBus API versioning

[Philip Van Hoof <spam pvanhoof be>]

During several IRC discussions we as a team decided to version the DBus
API of Tracker's master.

o. We decided to decouple the API version from the major version

o. We decided that we'd do this in a branch so that people can test
   their softwares against it, before we merge master with it

o. We decided to use 1 as the first API version, giving this schema:

Service   :  org.freedesktop.Tracker1
Interface :  org.freedesktop.Tracker1.Resources
Path      :   /org/freedesktop/Tracker1/Resources


The branch where this is implemented can be found here:
http://git.gnome.org/cgit/tracker/commit/?h=dbus-version


o. I decided not to rename the .service files, so they are still called
   org.freedesktop.Tracker.service. For now this means that it's not
   easy to install multiple releases of Tracker in parallel. This might
   change in near future and in the branch.

o. I decided to rename the miner's and the extractor's internal DBus
   APIs too

o. I decided to rename the Evolution and KMail plugin's names too, but
   given the nature of the specification this doesn't matter for end
   users (the registry communicates the path names and the changes get
   picked up automatically)

Conclusions

o. Yes we are aware that this breaks your application.
o. Indeed, we know that it breaks your application.
o. You are right that it breaks your application, and we also know that.
o. That's right, this breaks your application. You're right.

Why now?

o. Because if we'd do this after an alpha release, there will be even
   more of you people with broken applications.

Why don't you continue supporting the old API?

o. Because then you guys won't switch to the new one until we disable
   the old one. So it doesn't matter anyway. You'll just have to do it
   now, now that we haven't made any promises about what is in master
   yet.


Opinions?

/me puts on his armor



-- 
Philip Van Hoof, freelance software developer
home: me at pvanhoof dot be 
gnome: pvanhoof at gnome dot org 
http://pvanhoof.be/blog
http://codeminded.be