I'm not sure how semver applies here really - every number change (1->2) is a breaking change, and v2 could be marked as experimental in the docs until it is ready.
Not sure about restful yet - it might not provide much benefit to the users. I guess we should have either a different thread or bug reports discussing proposed structure change. On Fri, Dec 28, 2012 at 6:20 AM, Ed Summers <[email protected]> wrote: > Thanks for the additional details :-) > > Perhaps this isn't important right now, but have you given any thought > to the naming of the version? I kind of like the clarity and goals of > the semver system [1]. The reason why I bring this up is that fixing > existing bugs with the API sounds like minor change in the version > number, whereas a major change from (v1 -> v2) implies a break with > backwards compatibility to create a new API. Perhaps framing the work > in terms of semver will help organize the work? > > By the way, I quite like the sound of a modern looking (aka RESTful) > API for MediaWiki. Does that fit how you are thinking about v2 of the > API? > > //Ed > > [1] http://semver.org/ > > On Fri, Dec 28, 2012 at 6:10 AM, Yuri Astrakhan <[email protected]> > wrote: > > Bugzilla, mailing list archives, our heads. Now that versionning is > > per-module, we can start revising them one at a time to support new > > capabilities. Bugzilla has 150+ open API bugs. > > > > There is an API v2 tracking bug at > > https://bugzilla.wikimedia.org/show_bug.cgi?id=38891 > > Make sure bug 38891 depends on any v2 requests you add. > > > > All open API bugs: > > > https://bugzilla.wikimedia.org/buglist.cgi?order=Importance&query_format=advanced&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&component=API&component=BotQuery > > > > Or we could create an RFC at http://www.mediawiki.org/wiki/RFC > > > > > > On Fri, Dec 28, 2012 at 5:54 AM, Ed Summers <[email protected]> wrote: > >> > >> On Fri, Dec 28, 2012 at 5:45 AM, Yuri Astrakhan < > [email protected]> > >> wrote: > >> > Let the rotten egg throwing commence! > >> > >> Sorry to be dense, but where is a good place to learn about what > >> changes are in being planned for v2 of the API? > >> > >> //Ed > >> > >> _______________________________________________ > >> Mediawiki-api mailing list > >> [email protected] > >> https://lists.wikimedia.org/mailman/listinfo/mediawiki-api > > > > > > > > _______________________________________________ > > Mediawiki-api mailing list > > [email protected] > > https://lists.wikimedia.org/mailman/listinfo/mediawiki-api > > > > _______________________________________________ > Mediawiki-api mailing list > [email protected] > https://lists.wikimedia.org/mailman/listinfo/mediawiki-api >
_______________________________________________ Mediawiki-api mailing list [email protected] https://lists.wikimedia.org/mailman/listinfo/mediawiki-api
