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 <ehs@pobox.com> 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 <yuriastrakhan@gmail.com> 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 <ehs@pobox.com> wrote:
>>
>> On Fri, Dec 28, 2012 at 5:45 AM, Yuri Astrakhan <yuriastrakhan@gmail.com>
>> 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
>> Mediawiki-api@lists.wikimedia.org
>> https://lists.wikimedia.org/mailman/listinfo/mediawiki-api
>
>
>
> _______________________________________________
> Mediawiki-api mailing list
> Mediawiki-api@lists.wikimedia.org
> https://lists.wikimedia.org/mailman/listinfo/mediawiki-api
>

_______________________________________________
Mediawiki-api mailing list
Mediawiki-api@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/mediawiki-api