Requests for comment/Add developer link to footer of Wikimedia wikis

This page is mostly just notes related to 33464.

Position
The current footer links at https://en.wikipedia.org/ look like:

Contact us Privacy policy  About Wikipedia   Disclaimers   Mobile view

There seems to be wide agreement that adding the link after "Mobile view" would be best for now.

Why not use the "Powered By MediaWiki" button? That button is intended to advertise MediaWiki. This new link is intended to draw in developers who want to contribute code or re-use Wikimedia's content in their own projects.

Label

 * API
 * Developer Central
 * Developer hub
 * Developers
 * Get involved
 * Too confusing. Get involved with what?  If I saw this at the bottom of a Wikipedia page, I would assume it meant 'get involved with Wikipedia'.  Does not lead people to consider that it is anything to do with the software that is running the site. --HappyDog (talk) 10:49, 21 September 2012 (UTC)
 * Wikimedia developer hub
 * Definitely not! 'MediaWiki developer hub', perhaps, but if this new page is intended to be WMF-focussed then it should not be part of vanilla MW. --HappyDog (talk) 10:49, 21 September 2012 (UTC)

Destination

 * mw:API:Main page
 * Developer hub (Wikimedia developer hub)
 * Developer hub
 * Get involved
 * mw:Help:Contents
 * How to become a MediaWiki hacker
 * mw:Manual:Contents
 * MediaWiki
 * mw:Project:Help
 * Sysadmin hub
 * User hub
 * https://www.mediawiki.org/w/api.php

Examples

 * https://dev.twitter.com/
 * https://developers.facebook.com/
 * http://developer.wordnik.com/
 * http://www.flickr.com/services/developer/

Content
Items to possibly include or exclude:
 * m:Research:Index
 * Wikimedia update feed service
 * Data dumps
 * Tech
 * mw:API:Main page
 * https://www.mediawiki.org/w/api.php
 * Special:ApiSandbox
 * Code samples
 * mw:User:Sumanah/ApiDocsImprovement
 * Annoying little bugs
 * mw:API:Tutorial
 * Gadget kitchen
 * mw:Manual:Skins
 * mw:Manual:Extensions
 * https://bugs.mediawiki.org (filing and fixing!)
 * GitHub
 * Pretty icons similar to http://developer.wordnik.com
 * Pretty icons similar to http://developer.wordnik.com

Implementation

 * Must be translatable!
 * Must make sense in a vanilla MW installation, and on non-WMF sites!
 * One way of achieving this might be to have both the label and the URL customisable via the MediaWiki: namespace, with a default label of "Developers" pointing to a page on mw.org that is specifically about MW development, e.g. Developer hub. This landing page should contain no reference to anything WMF-specific at all.  On WMF wikis a different landing page could be used with more WMF-focussed content, and other users could similarly customise the destination if appropriate (e.g. Wikia might want to point to their own developer's hub). --HappyDog (talk) 11:02, 21 September 2012 (UTC)
 * We may want to include this link as part of MediaWiki core, but that's mostly separate from this RFC. This RFC is about the footer of Wikimedia wikis specifically. --MZMcBride (talk) 15:07, 21 September 2012 (UTC)
 * Should use a future-proof URL.
 * The URL that we embed into the software should be a new URL used specifically for just this one purpose. It should be chosen such that we never ever need to change the URL in the future, otherwise older installations will end up with dead links.  This is particularly important if we link to an existing page, which may end up evolving in a way that becomes no longer suitable as the destination for this link.  Existing suggestion is to have dedicated sub-domain (e.g. developers.mediawiki.org) which would redirect to the appropriate location.  This solves the problem, as if the ultimate destination is changed, we just need to update where the sub-domain is pointing to, without having to touch the software. --HappyDog (talk) 11:02, 21 September 2012 (UTC)

Idea 1
First, split by motivation:


 * I'm a developer. I want to:
 * re-use data from Wikimedia wikis for my own project; or
 * contribute code to Wikimedia wikis.

For the first branch ("re-use data"):
 * Possibilities
 * API
 * Data dumps
 * Squid cache
 * Toolserver
 * Wikimedia Labs
 * HTML dumps
 * For each possibility, explain issues with:
 * Speed (Toolserver replication is crazy fast; scanning dumps is super-slow)
 * Data currency (dumps are old; API is freshest)
 * Hosting (host yourself; host elsewhere [Labs and Toolserver])

For the second branch ("contribute code"):
 * I'm interested in or want to learn more about:
 * By programming language:
 * Lua/wiki templates --> Scribunto
 * JavaScript/CSS --> Gadgets
 * Puppet, LDAP, Apache, other shit --> operations part of Git
 * PHP --> MediaWiki extensions; patches to MediaWiki!; code review!
 * Python, Perl, etc. --> bots
 * C# and whatever --> Huggle, AWB, etc.
 * By part of the software:
 * User interface for everyone
 * User interface for specific tasks/people/etc.
 * Operations/system administration --> operations part of Git again
 * Other parts

Then have a "I'm confused and need help" section with links:
 * Mailing lists
 * IRC
 * Help page on-wiki
 * Tech (tech village pump)

Idea 2
Treat it as an appeal but aimed at developers rather than donatees.

I think a personal touch is a great way to explain to a would be developer to why they should care about our apis and our codebase. Hearing from real people with real problems that they are solving in the real world would be an extremely inspiring way to get new people involved

I think the home page should be written as a personal appeal to a new developer from ALL developers with links in the right places to the right thing. I think this should also be followed up by a randomised personal appeal from a developer himself - we should mix these between app developers, bug wranglers, feature developers, volunteers, employees etc etc

See Developer Hub for suggested "appeals"

Other entry points

 * http://developer.wikimedia.org/
 * http://developer.wikipedia.org/
 * http://developer.mediawiki.org