Re: [Wikitech-l] Proposal to add an API/Developer/Developer Hublink to the footer of Wikimedia wikis

2012-09-20 Thread Antoine Musso
Le 20/09/12 02:12, Tomasz Finc a écrit :
 I really wish I could just got to http://developer.wikimedia.org/
 and/or http://developer.wikipedia.org

The necessary Apache change is now in Gerrit:

  https://gerrit.wikimedia.org/r/24419

If we get consensus, we can get op to deploy that :)

-- 
Antoine hashar Musso


___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l


Re: [Wikitech-l] Proposal to add an API/Developer/Developer Hublink to the footer of Wikimedia wikis

2012-09-20 Thread Erik Moeller
On Wed, Sep 19, 2012 at 10:40 PM, Quim Gil quim...@gmail.com wrote:

 For instance, Twitter, Facebook etc are
 actually pushing open source projects themselves, but they don't mix
 those in their developer pages unless you dive deep and almost knowing
 what you are looking for.

Can I haz Facebook tarball? In seriousness, the utter open sourceness
of our codebase is what sets us apart, so we should make it clear
pretty prominently on our dev hub. For most platforms, cool open
source side projects notwithstanding, the API/SDK is all you get to
talk to the core platform - in our case you get the platform itself.
So I don't agree that we should point folks to the API first, and to
the platform second.

With that said, I agree that the dev hub currently is pretty much
inside baseball and we should try to make it more understandable if we
prominently link it from every footer of every page.

Erik
--
Erik Möller
VP of Engineering and Product Development, Wikimedia Foundation

Support Free Knowledge: https://wikimediafoundation.org/wiki/Donate

___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l


Re: [Wikitech-l] Proposal to add an API/Developer/Developer Hublink to the footer of Wikimedia wikis

2012-09-20 Thread Quim Gil
On Thu, Sep 20, 2012 at 2:11 AM, Erik Moeller e...@wikimedia.org wrote:
 the utter open sourceness
 of our codebase is what sets us apart, so we should make it clear
 pretty prominently on our dev hub.

(...)

 With that said, I agree that the dev hub currently is pretty much
 inside baseball and we should try to make it more understandable if we
 prominently link it from every footer of every page.

Alright, let's move onto the next round: which dev hub?

http://meta.wikimedia.org/wiki/Wikimedia_developer_hub
http://www.mediawiki.org/wiki/Developer_hub

mediawiki.org is a better default landing place for developers than
Meta, do you agree?

Is it worth considering the merge of both pages, as it has been suggested?

And in any case the API should be promoted upfront. Now the Meta hub
has no mention (I could find) while the dense MediaWiki hub features
the link if you are patient to find it (or you use the search, as I
did).

--
Quim

-- 
Quim Gil /// http://espiral.org

___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l


Re: [Wikitech-l] Proposal to add an API/Developer/Developer Hublink to the footer of Wikimedia wikis

2012-09-20 Thread James Forrester
On 20 September 2012 08:54, Quim Gil quim...@gmail.com wrote:
 On Thu, Sep 20, 2012 at 2:11 AM, Erik Moeller e...@wikimedia.org wrote:
 the utter open sourceness
 of our codebase is what sets us apart, so we should make it clear
 pretty prominently on our dev hub.

 (...)

 With that said, I agree that the dev hub currently is pretty much
 inside baseball and we should try to make it more understandable if we
 prominently link it from every footer of every page.

 Alright, let's move onto the next round: which dev hub?

 http://meta.wikimedia.org/wiki/Wikimedia_developer_hub
 http://www.mediawiki.org/wiki/Developer_hub

 mediawiki.org is a better default landing place for developers than
 Meta, do you agree?

 Is it worth considering the merge of both pages, as it has been suggested?

 And in any case the API should be promoted upfront. Now the Meta hub
 has no mention (I could find) while the dense MediaWiki hub features
 the link if you are patient to find it (or you use the search, as I
 did).

Of course, we already have a link to the mediawiki.org front page on
every page we serve - that's what the Powered by MediaWiki button
links to. There, the four most prominent links are:

* https://en.wikipedia.org/wiki/Wiki
* https://www.mediawiki.org/wiki/Installation
* https://www.mediawiki.org/wiki/Manual:Configuration
* https://www.mediawiki.org/wiki/How_to_become_a_MediaWiki_hacker

I assumed that the point of this additional link was to take people to
our API because we already use our bully-pulpit to ask for more
developers quite strongly, but people who want to use us as a service
need to dig further to even know we have one. If all we're doing is
duplicating the general hey, you're a techy person link with another
text label, this exercise will have lost its value.

J.
-- 
James D. Forrester
Product Manager, VisualEditor
Wikimedia Foundation, Inc.

jforres...@wikimedia.org | @jdforrester | +1 415-839-6885 x6844

___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l


Re: [Wikitech-l] Proposal to add an API/Developer/Developer Hublink to the footer of Wikimedia wikis

2012-09-19 Thread Quim Gil
On Tue, Sep 18, 2012 at 2:50 PM, Jon Robson jdlrob...@gmail.com wrote:
 At the danger of derailing/forking the conversation...

Your answer makes sense, thank you. I didn't want to kill the
discussion either...

Can we agree on this:

 If the primary target are app developers then
 http://www.mediawiki.org/wiki/API:Main_page + improvements is probably
 a better target. http://www.mediawiki.org/wiki/Developer_hub

 See full reasoning at
 https://bugzilla.wikimedia.org/show_bug.cgi?id=33464#c8

-- 
Quim

___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l


Re: [Wikitech-l] Proposal to add an API/Developer/Developer Hublink to the footer of Wikimedia wikis

2012-09-19 Thread Rob Lanphier
On Wed, Sep 19, 2012 at 4:36 PM, Quim Gil quim...@gmail.com wrote:
 If the primary target are app developers then
 http://www.mediawiki.org/wiki/API:Main_page + improvements is probably
 a better target. http://www.mediawiki.org/wiki/Developer_hub

 See full reasoning at
 https://bugzilla.wikimedia.org/show_bug.cgi?id=33464#c8

Generally, we want a single link that encapsulates everything a
developer might be interested in (Gadgets, MediaWiki extensions, the
web API, data dumps, bot infrastructure like pywikipediabot, MediaWiki
core development, generally volunteering, etc).  API:Main_page (for
better or worse) is focused on our web API.

Rob

___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l


Re: [Wikitech-l] Proposal to add an API/Developer/Developer Hublink to the footer of Wikimedia wikis

2012-09-19 Thread Jon Robson
I think we should point to a developer hub but the current one needs to be
massively revised!
On Sep 19, 2012 4:51 PM, Rob Lanphier ro...@wikimedia.org wrote:

 On Wed, Sep 19, 2012 at 4:36 PM, Quim Gil quim...@gmail.com wrote:
  If the primary target are app developers then
  http://www.mediawiki.org/wiki/API:Main_page + improvements is probably
  a better target. http://www.mediawiki.org/wiki/Developer_hub
 
  See full reasoning at
  https://bugzilla.wikimedia.org/show_bug.cgi?id=33464#c8

 Generally, we want a single link that encapsulates everything a
 developer might be interested in (Gadgets, MediaWiki extensions, the
 web API, data dumps, bot infrastructure like pywikipediabot, MediaWiki
 core development, generally volunteering, etc).  API:Main_page (for
 better or worse) is focused on our web API.

 Rob

 ___
 Wikitech-l mailing list
 Wikitech-l@lists.wikimedia.org
 https://lists.wikimedia.org/mailman/listinfo/wikitech-l

___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l


Re: [Wikitech-l] Proposal to add an API/Developer/Developer Hublink to the footer of Wikimedia wikis

2012-09-19 Thread Tomasz Finc
I really wish I could just got to http://developer.wikimedia.org/
and/or http://developer.wikipedia.org

--tomasz


On Wed, Sep 19, 2012 at 5:07 PM, Jon Robson jdlrob...@gmail.com wrote:
 I think we should point to a developer hub but the current one needs to be
 massively revised!
 On Sep 19, 2012 4:51 PM, Rob Lanphier ro...@wikimedia.org wrote:

 On Wed, Sep 19, 2012 at 4:36 PM, Quim Gil quim...@gmail.com wrote:
  If the primary target are app developers then
  http://www.mediawiki.org/wiki/API:Main_page + improvements is probably
  a better target. http://www.mediawiki.org/wiki/Developer_hub
 
  See full reasoning at
  https://bugzilla.wikimedia.org/show_bug.cgi?id=33464#c8

 Generally, we want a single link that encapsulates everything a
 developer might be interested in (Gadgets, MediaWiki extensions, the
 web API, data dumps, bot infrastructure like pywikipediabot, MediaWiki
 core development, generally volunteering, etc).  API:Main_page (for
 better or worse) is focused on our web API.

 Rob

 ___
 Wikitech-l mailing list
 Wikitech-l@lists.wikimedia.org
 https://lists.wikimedia.org/mailman/listinfo/wikitech-l

 ___
 Wikitech-l mailing list
 Wikitech-l@lists.wikimedia.org
 https://lists.wikimedia.org/mailman/listinfo/wikitech-l

___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l


Re: [Wikitech-l] Proposal to add an API/Developer/Developer Hublink to the footer of Wikimedia wikis

2012-09-19 Thread Risker
Without wanting to take away from the value of this suggestion, I'll just
point out that there's also not a link to Become an Editor either.
(Create an account doesn't really count, lots of people have accounts who
never edit.) I'll be the first to admit I'm in awe of the brain power on
this list, so this may be assuming too much of the intellect of developers
generally, but it's been my observation that those who are smart enough,
and interested enough, to write codeusually find their way around
pretty well.

I think RobLa's point is well taken, though. Decide what you want to say to
prospective developers, and make sure the landing page is welcoming and
useful, before you send anyone there.

Best,
Risker

On 19 September 2012 20:12, Tomasz Finc tf...@wikimedia.org wrote:

 I really wish I could just got to http://developer.wikimedia.org/
 and/or http://developer.wikipedia.org

 --tomasz


 On Wed, Sep 19, 2012 at 5:07 PM, Jon Robson jdlrob...@gmail.com wrote:
  I think we should point to a developer hub but the current one needs to
 be
  massively revised!
  On Sep 19, 2012 4:51 PM, Rob Lanphier ro...@wikimedia.org wrote:
 
  On Wed, Sep 19, 2012 at 4:36 PM, Quim Gil quim...@gmail.com wrote:
   If the primary target are app developers then
   http://www.mediawiki.org/wiki/API:Main_page + improvements is
 probably
   a better target. http://www.mediawiki.org/wiki/Developer_hub
  
   See full reasoning at
   https://bugzilla.wikimedia.org/show_bug.cgi?id=33464#c8
 
  Generally, we want a single link that encapsulates everything a
  developer might be interested in (Gadgets, MediaWiki extensions, the
  web API, data dumps, bot infrastructure like pywikipediabot, MediaWiki
  core development, generally volunteering, etc).  API:Main_page (for
  better or worse) is focused on our web API.
 
  Rob
 
  ___
  Wikitech-l mailing list
  Wikitech-l@lists.wikimedia.org
  https://lists.wikimedia.org/mailman/listinfo/wikitech-l
 
  ___
  Wikitech-l mailing list
  Wikitech-l@lists.wikimedia.org
  https://lists.wikimedia.org/mailman/listinfo/wikitech-l

 ___
 Wikitech-l mailing list
 Wikitech-l@lists.wikimedia.org
 https://lists.wikimedia.org/mailman/listinfo/wikitech-l

___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l


Re: [Wikitech-l] Proposal to add an API/Developer/Developer Hublink to the footer of Wikimedia wikis

2012-09-19 Thread Mono
I'm afraid that my opposition is rather frivolous, but is the ratio of
developers to laymen enough to justify adding the extra burden? It seems
some others have noted that if we include a developer hub, we can't stop
there. I could propose a research hub, a librarian hub, a photographer hub.
A developer outreach program might be better as it's unlikely anyone ever
even reads the links at the bottom.
On Wed, Sep 19, 2012 at 6:03 PM, Risker risker...@gmail.com wrote:

 Without wanting to take away from the value of this suggestion, I'll just
 point out that there's also not a link to Become an Editor either.
 (Create an account doesn't really count, lots of people have accounts who
 never edit.) I'll be the first to admit I'm in awe of the brain power on
 this list, so this may be assuming too much of the intellect of developers
 generally, but it's been my observation that those who are smart enough,
 and interested enough, to write codeusually find their way around
 pretty well.

 I think RobLa's point is well taken, though. Decide what you want to say to
 prospective developers, and make sure the landing page is welcoming and
 useful, before you send anyone there.

 Best,
 Risker

 On 19 September 2012 20:12, Tomasz Finc tf...@wikimedia.org wrote:

  I really wish I could just got to http://developer.wikimedia.org/
  and/or http://developer.wikipedia.org
 
  --tomasz
 
 
  On Wed, Sep 19, 2012 at 5:07 PM, Jon Robson jdlrob...@gmail.com wrote:
   I think we should point to a developer hub but the current one needs to
  be
   massively revised!
   On Sep 19, 2012 4:51 PM, Rob Lanphier ro...@wikimedia.org wrote:
  
   On Wed, Sep 19, 2012 at 4:36 PM, Quim Gil quim...@gmail.com wrote:
If the primary target are app developers then
http://www.mediawiki.org/wiki/API:Main_page + improvements is
  probably
a better target. http://www.mediawiki.org/wiki/Developer_hub
   
See full reasoning at
https://bugzilla.wikimedia.org/show_bug.cgi?id=33464#c8
  
   Generally, we want a single link that encapsulates everything a
   developer might be interested in (Gadgets, MediaWiki extensions, the
   web API, data dumps, bot infrastructure like pywikipediabot, MediaWiki
   core development, generally volunteering, etc).  API:Main_page (for
   better or worse) is focused on our web API.
  
   Rob
  
   ___
   Wikitech-l mailing list
   Wikitech-l@lists.wikimedia.org
   https://lists.wikimedia.org/mailman/listinfo/wikitech-l
  
   ___
   Wikitech-l mailing list
   Wikitech-l@lists.wikimedia.org
   https://lists.wikimedia.org/mailman/listinfo/wikitech-l
 
  ___
  Wikitech-l mailing list
  Wikitech-l@lists.wikimedia.org
  https://lists.wikimedia.org/mailman/listinfo/wikitech-l
 
 ___
 Wikitech-l mailing list
 Wikitech-l@lists.wikimedia.org
 https://lists.wikimedia.org/mailman/listinfo/wikitech-l

___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l


Re: [Wikitech-l] Proposal to add an API/Developer/Developer Hublink to the footer of Wikimedia wikis

2012-09-19 Thread Erik Moeller
On Wed, Sep 19, 2012 at 6:15 PM, Mono monom...@gmail.com wrote:
 I'm afraid that my opposition is rather frivolous, but is the ratio of
 developers to laymen enough to justify adding the extra burden? It seems
 some others have noted that if we include a developer hub, we can't stop
 there. I could propose a research hub, a librarian hub, a photographer hub.
 A developer outreach program might be better as it's unlikely anyone ever
 even reads the links at the bottom.

I don't see the slippery slope. All Wikimedia activities depend on a
thriving technical ecosystem. I strongly support the idea of surfacing
entrypoints for engineers (whether they want to work on our stuff, or
their own stuff) more prominently, as many other major websites do.

Making the open source nature of our projects more easily discoverable
is a Good Thing.

+1 for redirecting developers.wikimedia.org and
developer.wikimedia.org to
https://www.mediawiki.org/wiki/Developer_hub as well.
-- 
Erik Möller
VP of Engineering and Product Development, Wikimedia Foundation

Support Free Knowledge: https://wikimediafoundation.org/wiki/Donate

___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l


Re: [Wikitech-l] Proposal to add an API/Developer/Developer Hublink to the footer of Wikimedia wikis

2012-09-19 Thread Jeremy Baron
On Thu, Sep 20, 2012 at 1:22 AM, Erik Moeller e...@wikimedia.org wrote:
 +1 for redirecting developers.wikimedia.org and
 developer.wikimedia.org to
 https://www.mediawiki.org/wiki/Developer_hub as well.

Submitted in 
https://gerrit.wikimedia.org/r/#q,Ifa3c5e9988da162b2dde65e66bcb180f96161783,n,z

I also added develop.wm.o and did them all for wikipedia.org too.
(waiting for review so we can still change the set of domains later
and of course they're always subject to change even after deployed)

-Jeremy

___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l


Re: [Wikitech-l] Proposal to add an API/Developer/Developer Hublink to the footer of Wikimedia wikis

2012-09-19 Thread S Page
On Tue, Sep 18, 2012 at 9:51 AM, Sumana Harihareswara suma...@wikimedia.org
 wrote:

 ... And to help new developers discover various cross-Wikimedia tech
 projects, there is https://meta.wikimedia.org/wiki/Wikimedia_developer_hub.


but the conversation seems to be zeroing in on
https://www.mediawiki.org/wiki/Developer_hubhttp://www.mediawiki.org/wiki/Developer_hub

I don't understand the difference, I challenge anyone to explain it in less
than ten words, so I propose the page on meta should become a soft
redirect.  Every additional page (and its associated talk page!) adds a
cognitive and maintenance burden, hinders community, and diminishes focus,
and two Hubs with indistinguishable names is a bicycle.

(The one true Developer hub can still have a section(s) about other
WikiMedia Foundation software projects besides the Mediawiki software)

--
=S Page  software engineer on E3
___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l


Re: [Wikitech-l] Proposal to add an API/Developer/Developer Hublink to the footer of Wikimedia wikis

2012-09-19 Thread Quim Gil
On Wed, Sep 19, 2012 at 4:50 PM, Rob Lanphier ro...@wikimedia.org wrote:
 On Wed, Sep 19, 2012 at 4:36 PM, Quim Gil quim...@gmail.com wrote:
 If the primary target are app developers then
 http://www.mediawiki.org/wiki/API:Main_page + improvements is probably
 a better target. http://www.mediawiki.org/wiki/Developer_hub

 See full reasoning at
 https://bugzilla.wikimedia.org/show_bug.cgi?id=33464#c8

 Generally, we want a single link that encapsulates everything a
 developer might be interested in (Gadgets, MediaWiki extensions, the
 web API, data dumps, bot infrastructure like pywikipediabot, MediaWiki
 core development, generally volunteering, etc).  API:Main_page (for
 better or worse) is focused on our web API.

By trying to make everybody happy we risk not making happy anybody.

Application developers and Wikimedia/Mediawiki contributors are very
different types of profiles with very different goals. The initial
proposal of this thread was to follow the path of major sites offering
visibly a link to their API in order to increase and diversify the use
of their data and services in the hands of third party developers. I
personally agree that such visibility is missing and a link to the API
main page would be a good and simple start. This is also a clear
incentive to improve the API pages, a plan that seems to be in the
ToDo list at least since January.

The Wikimedia Developer Hub could be visibly featured in the API page
in order to redirect those willing to know more about other
interesting stuff for developers around Wikimedia projects and the
MediaWiki context.

Maybe one day the Wikimedia Developer Hub will be just great, not
confusing at all for application developers and other profiles? Great,
then we an agree to change the link. Easy. But as for today polishing
a bit the API main page seems a more feasible task and would do
wonders for all those app developers.

-- 
Quim

___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l


Re: [Wikitech-l] Proposal to add an API/Developer/Developer Hublink to the footer of Wikimedia wikis

2012-09-19 Thread Quim Gil
On Wed, Sep 19, 2012 at 6:22 PM, Erik Moeller e...@wikimedia.org wrote:
 Making the open source nature of our projects more easily discoverable
 is a Good Thing.

Indeed, but mixing public APIs with 1001 open source possibilities
tends to make more happy the smaller circle of insiders and free
software developers than the average developers just willing to build
their great app or service. For instance, Twitter, Facebook etc are
actually pushing open source projects themselves, but they don't mix
those in their developer pages unless you dive deep and almost knowing
what you are looking for.

In the same footer there is an icon Powered by Mediawiki. For the
sake of simplicity we could direct app developers to the API through
the new Developers link and use the Mediawiki brand  homepage as an
umbrella for all the open source collaboration, which is mostly what
the Wikimedia/Mediawiki Developer Hubs are about. Did someone mention
that there is also an initiative to revamp the mediawiki.org homepage?

Please consider that what seems obvious for you is not obvious at all
for a newcomer in a hurry or someone thinking what will be her next
app about. Grasping that Wikimedia is not a typo and understanding
what it means is already a big step. And then getting the Mediawiki
thing is another step further. We need to simplify all this, at least
for newcomers. The risk of them thinking uff, I'll have a better look
another day is pretty high.

-- 
Quim

___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l


Re: [Wikitech-l] Proposal to add an API/Developer/Developer Hublink to the footer of Wikimedia wikis

2012-09-18 Thread Mark Clements (HappyDog)
dan entous d_ent...@yahoo.com wrote in message 
news:75e303e6-3ec7-4a17-824e-c3d8d3378...@yahoo.com...

how about here :
http://www.mediawiki.org/wiki/Manual:Contents

... and add in any resources that may be missing to those pages.

with kind regards,
dan



I would much rather it went to a new page, dedicated for this exact purpose. 
Manual:Contents is the contents page for the manual, and I can see that once 
this is implemented there will be feature creep which will move it away from 
its original purpose.


One of the hubs might be appropriate ([[mw:User hub]], [[mw:Sysadmin hub]] 
or [[mw:Developer hub]] - all of which need some tlc), but perhaps we need a 
new more-tightly-focussed page that spans user-types.


Personally, I would recommend that we create [[mw:Get involved]] if it is 
about general MW involvement or perhaps [[meta:Developer hub]] if it's more 
WMF focussed (or has that all moved to mw.org now - I am not so clear about 
the distinction as I used to be).


- HappyDog

(cross-posted to https://bugzilla.wikimedia.org/show_bug.cgi?id=33464) 




___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l


Re: [Wikitech-l] Proposal to add an API/Developer/Developer Hublink to the footer of Wikimedia wikis

2012-09-18 Thread Jon Robson
This is a great idea but we would really need to build several new pages
ideally with links to the API sandbox, code samples. This is a big project
in itself. The landing page should be close to something like Flickr [1]
and should detail why someone would want to be a developer, the sort of
things they can develop and with what skill set and should give a brief but
interesting overview of apps/sites that use the API or extend mediawiki in
drastic ways. Part of said page should be about inspiring people to develop
with us rather than elsewhere.

I'm happy to use my 20% time to work on this with people. Just give me a
shout offlist.

[1]http://www.flickr.com/services/developer/
On Sep 18, 2012 4:49 AM, Mark Clements (HappyDog) gm...@kennel17.co.uk
wrote:

 dan entous d_ent...@yahoo.com wrote in message
 news:75E303E6-3EC7-4A17-824E-**c3d8d3378...@yahoo.com...

 how about here :
 http://www.mediawiki.org/wiki/**Manual:Contentshttp://www.mediawiki.org/wiki/Manual:Contents

 ... and add in any resources that may be missing to those pages.

 with kind regards,
 dan


 I would much rather it went to a new page, dedicated for this exact
 purpose. Manual:Contents is the contents page for the manual, and I can see
 that once this is implemented there will be feature creep which will move
 it away from its original purpose.

 One of the hubs might be appropriate ([[mw:User hub]], [[mw:Sysadmin hub]]
 or [[mw:Developer hub]] - all of which need some tlc), but perhaps we need
 a new more-tightly-focussed page that spans user-types.

 Personally, I would recommend that we create [[mw:Get involved]] if it is
 about general MW involvement or perhaps [[meta:Developer hub]] if it's more
 WMF focussed (or has that all moved to mw.org now - I am not so clear
 about the distinction as I used to be).

 - HappyDog

 (cross-posted to 
 https://bugzilla.wikimedia.**org/show_bug.cgi?id=33464https://bugzilla.wikimedia.org/show_bug.cgi?id=33464)



 __**_
 Wikitech-l mailing list
 Wikitech-l@lists.wikimedia.org
 https://lists.wikimedia.org/**mailman/listinfo/wikitech-lhttps://lists.wikimedia.org/mailman/listinfo/wikitech-l

___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l


Re: [Wikitech-l] Proposal to add an API/Developer/Developer Hublink to the footer of Wikimedia wikis

2012-09-18 Thread Sumana Harihareswara
Jon, if you want to take the lead on this, go ahead.
https://www.mediawiki.org/wiki/User:Sumanah/ApiDocsImprovement has some
thoughts that Ben Lobaugh had put together (including the Flickr
example) in case you find those useful.

-- 
Sumana Harihareswara
Engineering Community Manager
Wikimedia Foundation

On 09/18/2012 12:34 PM, Jon Robson wrote:
 This is a great idea but we would really need to build several new pages
 ideally with links to the API sandbox, code samples. This is a big project
 in itself. The landing page should be close to something like Flickr [1]
 and should detail why someone would want to be a developer, the sort of
 things they can develop and with what skill set and should give a brief but
 interesting overview of apps/sites that use the API or extend mediawiki in
 drastic ways. Part of said page should be about inspiring people to develop
 with us rather than elsewhere.
 
 I'm happy to use my 20% time to work on this with people. Just give me a
 shout offlist.
 
 [1]http://www.flickr.com/services/developer/
 On Sep 18, 2012 4:49 AM, Mark Clements (HappyDog) gm...@kennel17.co.uk
 wrote:
 
 dan entous d_ent...@yahoo.com wrote in message
 news:75E303E6-3EC7-4A17-824E-**c3d8d3378...@yahoo.com...

 how about here :
 http://www.mediawiki.org/wiki/**Manual:Contentshttp://www.mediawiki.org/wiki/Manual:Contents

 ... and add in any resources that may be missing to those pages.

 with kind regards,
 dan


 I would much rather it went to a new page, dedicated for this exact
 purpose. Manual:Contents is the contents page for the manual, and I can see
 that once this is implemented there will be feature creep which will move
 it away from its original purpose.

 One of the hubs might be appropriate ([[mw:User hub]], [[mw:Sysadmin hub]]
 or [[mw:Developer hub]] - all of which need some tlc), but perhaps we need
 a new more-tightly-focussed page that spans user-types.

 Personally, I would recommend that we create [[mw:Get involved]] if it is
 about general MW involvement or perhaps [[meta:Developer hub]] if it's more
 WMF focussed (or has that all moved to mw.org now - I am not so clear
 about the distinction as I used to be).

 - HappyDog

 (cross-posted to 
 https://bugzilla.wikimedia.**org/show_bug.cgi?id=33464https://bugzilla.wikimedia.org/show_bug.cgi?id=33464)



 __**_
 Wikitech-l mailing list
 Wikitech-l@lists.wikimedia.org
 https://lists.wikimedia.org/**mailman/listinfo/wikitech-lhttps://lists.wikimedia.org/mailman/listinfo/wikitech-l

 ___
 Wikitech-l mailing list
 Wikitech-l@lists.wikimedia.org
 https://lists.wikimedia.org/mailman/listinfo/wikitech-l
 

___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l


Re: [Wikitech-l] Proposal to add an API/Developer/Developer Hublink to the footer of Wikimedia wikis

2012-09-18 Thread Derric Atzrott
This is a great idea but we would really need to build several new pages
ideally with links to the API sandbox, code samples. This is a big project
in itself. The landing page should be close to something like Flickr [1]
and should detail why someone would want to be a developer, the sort of
things they can develop and with what skill set and should give a brief but
interesting overview of apps/sites that use the API or extend mediawiki in
drastic ways. Part of said page should be about inspiring people to develop
with us rather than elsewhere.

I'm happy to use my 20% time to work on this with people. Just give me a
shout offlist.

[1]http://www.flickr.com/services/developer/


It should definitely link to the Annoying little bugs page as well.  It contains
a decent selection of bugs that new developers can fix.

Not 100% sure the scope of this page though.  Was it meant to attract just
extension, gadget, et. al developers?  Or was it also meant to attract
developers for the core as well?

Thank you,
Derric Atzrott


___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l


Re: [Wikitech-l] Proposal to add an API/Developer/Developer Hublink to the footer of Wikimedia wikis

2012-09-18 Thread Sumana Harihareswara
On 09/18/2012 12:44 PM, Derric Atzrott wrote:
 It should definitely link to the Annoying little bugs page as well.  It 
 contains
 a decent selection of bugs that new developers can fix.
 
 Not 100% sure the scope of this page though.  Was it meant to attract just
 extension, gadget, et. al developers?  Or was it also meant to attract
 developers for the core as well?
 
 Thank you,
 Derric Atzrott

To help new developers get into MediaWiki core and extensions, there's
https://www.mediawiki.org/wiki/How_to_become_a_MediaWiki_hacker (which
does of course link to Annoying Little Bugs).  To help new developers
get into the web API, there's
https://www.mediawiki.org/wiki/API:Tutorial and
https://www.mediawiki.org/wiki/API although I know these aren't as great
as the API documentation that Meetup, Etsy, Flickr, and similar sites
provide.  To help new gadget developers, there is
https://www.mediawiki.org/wiki/Gadget_kitchen .  And to help new
developers discover various cross-Wikimedia tech projects, there is
https://meta.wikimedia.org/wiki/Wikimedia_developer_hub .

Just wanted people to know so they don't reinvent the wheel. :)

-- 
Sumana Harihareswara
Engineering Community Manager
Wikimedia Foundation

___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l


Re: [Wikitech-l] Proposal to add an API/Developer/Developer Hublink to the footer of Wikimedia wikis

2012-09-18 Thread Mark Holmquist

Just wanted people to know so they don't reinvent the wheel. :)


Along that vein, there are the ever popular skin manual [0] and 
extension manual [1].


[0] http://www.mediawiki.org/wiki/Manual:Skins
[1] http://www.mediawiki.org/wiki/Manual:Extensions

--
Mark Holmquist
Software Engineer, Wikimedia Foundation
mtrac...@member.fsf.org
http://marktraceur.info

___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l


Re: [Wikitech-l] Proposal to add an API/Developer/Developer Hublink to the footer of Wikimedia wikis

2012-09-18 Thread Rob Lanphier
On Tue, Sep 18, 2012 at 9:51 AM, Sumana Harihareswara
suma...@wikimedia.org wrote:
 And to help new
 developers discover various cross-Wikimedia tech projects, there is
 https://meta.wikimedia.org/wiki/Wikimedia_developer_hub .

 Just wanted people to know so they don't reinvent the wheel. :)

My 2c: the Wikimedia developer hub page on meta should be the
starting point.  Let's not create yet another central page.  If we
do end up bikeshedding our way to a different URL, please someone make
sure there's a redirect from the page above to the new page rather
than keeping the old one around out of nostalgia.

Rob

___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l


Re: [Wikitech-l] Proposal to add an API/Developer/Developer Hublink to the footer of Wikimedia wikis

2012-09-18 Thread Quim Gil
Hi,

On Tue, Sep 18, 2012 at 1:11 PM, Rob Lanphier ro...@wikimedia.org wrote:
 My 2c: the Wikimedia developer hub page on meta should be the
 starting point.  Let's not create yet another central page.

If the primary target are app developers then
http://www.mediawiki.org/wiki/API:Main_page + improvements is probably
a better target. http://www.mediawiki.org/wiki/Developer_hub

See full reasoning at https://bugzilla.wikimedia.org/show_bug.cgi?id=33464#c8


PS: when a bug report is advertized in a mailing list it is more
useful to have the discussion archived around the bug report - do you
agree?

-- 
Quim

___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l


Re: [Wikitech-l] Proposal to add an API/Developer/Developer Hublink to the footer of Wikimedia wikis

2012-09-18 Thread Jon Robson
At the danger of derailing/forking the conversation...

My preference with bugzilla is to only raise bugs when the outcome is
clear. The test I use is if I gave a bug to a newbie could they pick it up
and fix it without any questions. If it's not clear I'd start a mailing
list conversation with the outcome of cutting a new bug with decisions made.

My worry with using bugzilla as the place of discussion is that a bug can
get extremely confusing - especially when people have differing views.

The result of this is a manageable bug list for the mobile site [1] which
could one day be empty and is much more manageable.

[1]
https://bugzilla.wikimedia.org/buglist.cgi?list_id=147228field0-0-0=bug_severityresolution=---resolution=LATERresolution=DUPLICATEquery_based_on=MFEquery_format=advancedbug_status=UNCONFIRMEDbug_status=NEWbug_status=ASSIGNEDbug_status=REOPENEDtype0-0-0=notequalsvalue0-0-0=enhancementcomponent=MobileFrontendproduct=MediaWiki%20extensionsknown_name=MFE

On Tue, Sep 18, 2012 at 1:31 PM, Quim Gil quim...@gmail.com wrote:

 Hi,

 On Tue, Sep 18, 2012 at 1:11 PM, Rob Lanphier ro...@wikimedia.org wrote:
  My 2c: the Wikimedia developer hub page on meta should be the
  starting point.  Let's not create yet another central page.

 If the primary target are app developers then
 http://www.mediawiki.org/wiki/API:Main_page + improvements is probably
 a better target. http://www.mediawiki.org/wiki/Developer_hub

 See full reasoning at
 https://bugzilla.wikimedia.org/show_bug.cgi?id=33464#c8


 PS: when a bug report is advertized in a mailing list it is more
 useful to have the discussion archived around the bug report - do you
 agree?

 --
 Quim

 ___
 Wikitech-l mailing list
 Wikitech-l@lists.wikimedia.org
 https://lists.wikimedia.org/mailman/listinfo/wikitech-l




-- 
Jon Robson
http://jonrobson.me.uk
@rakugojon
___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l