I've had the privilege of meeting Frances and very much hope that I get
to mentor and teach her (along with Tollef, Brad, and Merlijn) this
year. I think her microtask
https://www.mediawiki.org/wiki/API:Client_Code/Access_Library_Comparison
is a reasonable start at evaluating how complete, well-documented, and
easy-to-use the Python client libraries are. If you've noticed
idiosyncrasies in any of those libraries, I'd like to know so we can
mark them for further investigation and possible fixing!
I developed the basic idea for this internship project along with RobLa,
Quim, and Frances, and I think it's pretty sound. The list of client
libraries has been a bit of a mess for a while now, and I look forward
to being able to Officially Recommend some libraries, and work with
their maintainers more systematically (as Frances will in the last part
of her internship, when she improves one of them).
Frances, it would be great if you'd cross-post this thread to the
MediaWiki API mailing list
https://lists.wikimedia.org/mailman/listinfo/mediawiki-api so developers
there can check out your work and talk about their favorite libraries.
Thanks!
--
Sumana Harihareswara
Senior Technical Writer
Wikimedia Foundation
On 03/19/2014 07:36 AM, Frances Hocutt wrote:
> I have updated my microtask [1] and my status page [2] with the last
> week's work, and my application [3] is complete.
>
> -Frances
>
> [1]
https://www.mediawiki.org/wiki/API:Client_Code/Access_Library_Comparison
> [2]
https://www.mediawiki.org/w/index.php?title=User:Fhocutt#Status
> [3]
https://www.mediawiki.org/wiki/Evaluating_MediaWiki_web_API_client_libraries
>
> On Tue, Mar 18, 2014 at 3:03 AM, Frances Hocutt
>
frances.hocutt@gmail.com wrote:
>> I have updated and expanded the scope of my OPW project [1],
>> Evaluating and Improving MediaWiki Web API Client Libraries. Thanks to
>> Sumana, Tollef, and Brad for their help!
>>
>> -Frances
>>
>> [1]
https://www.mediawiki.org/wiki/Evaluating_MediaWiki_web_API_client_libraries
>>
>> On Fri, Mar 14, 2014 at 12:20 AM, Frances Hocutt
>>
frances.hocutt@gmail.com wrote:
>>> Hello!
>>>
>>> My name is Frances Hocutt, and I'm applying for the OPW internship
>>> program. Specifically, I'm interested in improving the documentation
>>> around the available Mediawiki API libraries, writing specifications for what
>>> makes a good one, and generally making API:Client Code a more useful page.
>>> I've been coordinating my application with Sumana Harihareswara, and my co-
>>> mentor will be Tollef Fog Heen. Brad Jorsch and Merlijn van Deen have
>>> agreed to offer technical advice as well. Thanks to everyone!
>>>
>>> You can find my userpage here:
>>>
https://www.mediawiki.org/wiki/User:Fhocutt. I've been drafting my
>>> proposal here:
https://www.mediawiki.org/wiki/Evaluating_MediaWiki_web_API_client_libraries
>>> (working title). And I've started a page for my microtask here:
>>>
https://www.mediawiki.org/wiki/API:Client_Code/Access_Library_Comparison.
>>> I'll be comparing two of the Python API libraries; right now I'm figuring out
>>> what criteria I'll be using. I'm looking at the Google Android, Drive, and
>>> Youtube API documentation along with the AWS S3 Ruby API as starting
>>> examples. Are there any other API client libraries that you've found exemplary,
>>> related to Wikimedia or not?
>>>
>>> Looking forward to contributing,
>>>
>>> Frances Hocutt