The Developer Hub prototype requires a prototype homepage.
It's at http://devhub.wmflabs.org/wiki/Dev:Data_and_developer_hub with the Blueprint skin.
The Developer Hub prototype requires a prototype homepage.
It's at http://devhub.wmflabs.org/wiki/Dev:Data_and_developer_hub with the Blueprint skin.
Subject | Repo | Branch | Lines +/- | |
---|---|---|---|---|
dev.wikimedia.org: delete puppet module | operations/puppet | production | +0 -63 | |
misc-web: delete Varnish config for dev.wikimedia | operations/puppet | production | +1 -1 |
Reference | Source Branch | Dest Branch | Author | Title | |
---|---|---|---|---|---|
repos/mediawiki/services/ipoid!66 | update-readme | main | stran | Update README.md | |
repos/releng/cli!181 | restart-command | main | ollieshotton | Add a `restart` command to `mw docker` |
For February, I will write initial Showcase/Inspire articles on mediawiki.org, do some polishing of the APIs they use (T306), and have basic "sandbox" functionality via "click this link to see API results". Those will be enough to present developer hub homepage similar to the wireframes on mw.org.
I'll probably put the page in the API: namespace.
For March we'll explore/prototype other features of the developer hub: dedicated namespace (T369), custom skin (T301: Define the look&feel of the Developer Hub), special API sandbox code, etc.
Thanks!
"Back to How to contribute" assumes that you come from there, which is perhaps a too big assumption.
In fact, we need to think about users landing in this homepage first, without having seen anything else of mediawiki.org. I would add a section at the end including a link to the Developer Hub for developers of MediaWiki, the 2-3 most important pages related to Documentation, and How to Contribute (not necessarily in this order).
Yup, rephrased.
In fact, we need to think about users landing in this homepage first, without having seen anything else of mediawiki.org.
I added an introductory sentence.
I would add a section at the end including a link to the Developer Hub for developers of MediaWiki, the 2-3 most important pages related to Documentation, and How to Contribute (not necessarily in this order).
If someone arrived here without having seen anything else, How to contribute can't be beat as a link back out, and I'm leery of offering any other links. Either developers are inspired to read more and explore or the page failed. (Of course if and when dev pages have their own skin we can guide users with top- and left-nav like, e.g. dev.mozilla.org.)
I think the current homepage (and plan in general, probably) reflects that we are focusing on the developers (contributors) we already have around. In fact, dev.wikimedia.org needs to be efficient to the big majority of developers that we still don't have around. Most of them will not be "contributors", but "selfish" developers needing something and leaving with it... until the next time they need something else. I'm proposing T92941: Define personas for dev.wikimedia.org to solve this problem of lack of an agreed audience beyond "users of our APIs".
A consequence of the above is that we are not explaining what Wikimedia can offer to developers, because this is kind of obvious when you are already a tech contributor. However, this needs to be explained to all the new developers. Let's solve this part of the homepage in T92945: Reflect in dev.wikimedia.org what Wikimedia offers to developers.
When these two tasks are clear, then the homepage will be clearer and sharper as well. Inspire looks good and I can't wait to see more items listed. I would focus on title and image only, no description. The upper part of the homepage should be very visual, betting on bigger images and less text. Explore is good. Build needs work.
"There are many other ways to contribute" can be fine tuned once we have defined T92945 and when we work on the actual look & feel of the homepage (T301).
Another problem that is becoming more apparent is the navigation. How to walk through the hub finding what you need but not ending up swamped in semi-random destinations in mediawiki.org? But this has other important implications, and I will bring the discussion to T312. Let's forget about the navigation here.
Now we have an intro with pure text in the homepage. I think it would be good to give a clear visual cue to our readers about the types of content found. The text mentions text, media, and data, and we could use one icon for each, since there are plenty of icons to chose from with the paradigms "doc", "media", "database".
In fact, Wikifont provides two reusable icons already:
https://www.mediawiki.org/wiki/File:Article_icon.svg
https://www.mediawiki.org/wiki/File:PhotoGallery.svg
... and this one looks like a good candidate for the third.
https://www.mediawiki.org/wiki/File:PhotoGallery.svg
Good enough for a prototype, I would say.
This task was part of ECT-March-2015, and it is still open and assigned. Assuming that it belongs to ECT-April-2015 as well. Otherwise please edit accordingly.
https://dev.wikimedia.org/ works now and redirects to https://www.mediawiki.org/wiki/API:Data_and_developer_hub
That's the same icon as for media, copy-paste error? I used File:Keyboard_switch.svg for data.
It's up at http://devhub.wmflabs.org/wiki/API:Data_and_developer_hub.
I also
Definition of done? :-)
Good!
I made some more edits to reflect what I had in mind with the use of icons and polish the text of the main section of the homepage.
We don't need the page title in the homepage ("API:Data and developer hub"), and we will apply the kind of tricks that almost every single MediaWiki instance has to use, see https://www.mediawiki.org/wiki/Manual:FAQ#How_do_I_hide_the_main_page_title.3F
After this, I think we can resolve this task. Not that I think the homepage is spectacular, but at least reflects what two non-designers were after in this prototype. :)
Compare Qgil's revision with previous. IMO the big icons overpower the "Inspire" screenshots below, we'll see.
BTW, any edits made on devhub are blown away when I Special:Import from mw.org, so I manually recreated those edits on mw.org (while waiting for DWVS, distributed wiki version system :-) ).
We don't need the page title in the homepage ("API:Data and developer hub")
That was a killer, exposing bugs T103454: Blueprint skin crashes in Title::equals() if you blank the title and T103488: Blueprint sidebar nav shows CSS if you use {{DISPLAYTITLE}}. I have patches for both. I earlier
After this, I think we can resolve this task. Not that I think the homepage is spectacular, but at least reflects what two non-designers were after in this prototype. :)
Remaining bugs/good ideas (also see T103986: issues with Data and Developer Hub prototype (tracking))
In case you haven't already, you might enjoy reading this: https://en.wikipedia.org/wiki/User:HaeB/Timeline_of_distributed_Wikipedia_proposals
Change 220498 had a related patch set uploaded (by Dzahn):
misc-web: delete Varnish config for dev.wikimedia
Change 220504 had a related patch set uploaded (by Dzahn):
dev.wikimedia.org: delete puppet module