Hi Platonides, sorry but I don't see the connection with 927 (funny thing is being such a big fan of Randall I did not even had to look it up :D), if you're referring to the proposal as a whole then what we're trying to do here is to adopt a couple of standards rather than coming up with yet another one.
Concerning versioning, despite I agree that no system is able to keep backwards compatibility forever (as any software solution reaches the end of its' lifecycle sooner or later depending on how manageable it is to keep updating/improving it), how you implement versioning in an API is actually a very important factor for ensuring future backwards compatibility: when an hypothetical /rest/v2/xyz resource would be made available, the previous /rest/v1/xyz would be left intact, where the v2 xyz resource could be a direct descendant of v1 to avoid code duplication and simplify maintenance tasks. This is just one of many options, the important thing is to keep versioning into high consideration when designing a new API and that's something we're doing for this proposal. On Sat, Nov 10, 2012 at 5:04 PM, Platonides <[email protected]> wrote: > On 10/11/12 03:44, Federico "Lox" Lucignano wrote: > > stability (versioning, i.e. no more mass > > transitions), > > This is really asking for a reference to xkcd 927 :) > > Note that no matter how you versionate the api (heh, we could easily add > a version parameter to the current one, too) if for some reason (eg. a > new HTML5 feature allows to bypass one of the checks of the current api) > it needs to be changed, we *will* break backwards compatibility. > > It is uncommon that it happens, but we have been there, and the same > situation may arise in the future, too. > In the past we managed to keep BC quite well, though. > > _______________________________________________ > Mediawiki-api mailing list > [email protected] > https://lists.wikimedia.org/mailman/listinfo/mediawiki-api > -- --- Federico "Lox" Lucignano Senior Lead Engineer - Mobile Team Wikia sp.z.o.o. email: [email protected] web: Lox-o-Drome <http://lox-o-drome.blogspot.com>
_______________________________________________ Mediawiki-api mailing list [email protected] https://lists.wikimedia.org/mailman/listinfo/mediawiki-api
