Fwd: [Wikitech-l] OPW applicant introduction - Evaluating and Improving API Client Libraries - Mediawiki-api

24 Mar 2014

I've applied to the Outreach Program for Women internship this summer,
intending to clean up API::Client Code by evaluating the listed API
client libraries and contributing to one of the best of those. My
proposal is here
(https://www.mediawiki.org/wiki/Evaluating_MediaWiki_web_API_client_libraries)
and my microtask is here
(https://www.mediawiki.org/wiki/API:Client_Code/Access_Library_Comparison).

If you have comments on my proposal or emphatic opinions about your
favorite API libraries, I'd love to hear them.

-Frances

---------- Forwarded message ----------
From: Sumana Harihareswara &lt;sumanah(a)wikimedia.org&gt;
Date: Sun, Mar 23, 2014 at 5:07 PM
Subject: Re: [Wikitech-l] OPW applicant introduction
To: Wikimedia developers &lt;wikitech-l(a)lists.wikimedia.org&gt;

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
 &lt;frances.hocutt(a)gmail.com&gt; 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
> &lt;frances.hocutt(a)gmail.com&gt; 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 
_______________________________________________
Wikitech-l mailing list
Wikitech-l(a)lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l