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 > <[email protected]> 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 >> <[email protected]> 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 [email protected] https://lists.wikimedia.org/mailman/listinfo/wikitech-l
