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
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
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
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!
wikitech-l@lists.wikimedia.org