Goal: Integrate the new Web APIs hub with mediawiki.org
Closed, ResolvedPublic
Actions

Assigned To

Authored By

	• Spage
	Jun 4 2015, 8:44 PM

Description

Part of T101100: Engineering Community quarterly goals for July-September 2015

Result

Partially completed

New Web APIs hub is ready for 3rd party developers.

A process for contributing documentation exists.

BUT Blueprint skin available only in prototype, not mediawiki.org, due to lack of UX resources and community resistance.

@Spage (previously in Engineering Community) was on loan from Reading to work on this goal.
@Volker_E (Reading Design) went beyond call of duty volunteering many fixes to Blueprint skin.
Plan to keep writing documentation based on explicit needs from developers using our APIs.
UX refresh priority demoted as long as UX resources are not committed.

This task is closed as a quarterly goal. The open blockers will be pursued on their own priorities.

Previous description

The prototype on http://devhub.wmflabs.org/wiki/Dev:Data_and_developer_hub for T307: Announcing the Developer Hub prototype release is a short-term solution.

The goal is a coherent experience for third-party developers, whether entering from

https://www.mediawiki.org
- front page, How to contribute, etc.
https://dev.wikimedia.org

It would help if T93610: Put WikimediaUI Style Guide on mediawiki.org was a priority for other teams, since it shares dependencies.

Measurement of success

New Developer Hub available in mediawiki.org with basic content and coherent user experience.
Community process to propose and contribute documentation.

Dependencies

Blueprint maintainers (Reading Design)
mediawiki.org community (fuzzy)

ETA

DevRel-September-2015

Relation with WMF Call to Action

EXPERIMENT: support innovation & new knowledge

T98359: Create spaces for future community-led innovations and new knowledge creation

Related Objects
Search...

Status	Assigned	Task
Resolved	Volker_E	T111117 [EPIC] Enhance accessibility of OOUI & MediaWiki UI library / LSG / MediaWiki General to screen readers and color-deficient users
Resolved	None	T88023 Create landmarks for screen reader
Declined	None	T103986 issues with Data and Developer Hub prototype (tracking)
Declined	None	T110835 `blueprint-left-nav` message doesn't seem to be localizable
Resolved	Qgil	T101099 Developer Relations Roadmap
Resolved	Qgil	T113030 Developer Relations quarterly review Jul-Sep 2015
Resolved	Qgil	T101100 Engineering Community quarterly goals for July-September 2015
Resolved	• Spage	T101441 Goal: Integrate the new Web APIs hub with mediawiki.org
Declined	None	T98897 Deploy SkinPerNamespace extension on mediawiki.org
Resolved	• Spage	T102865 Create MediaWiki-extensions-SkinPerNamespace project
Resolved	• Spage	T305 Developer Hub homepage
Declined	None	T317 "Terms of Use" must be prominently featured in the Developer Hub
Resolved	• Spage	T301 Define the look&feel of the Developer Hub
Declined	None	T93613 Deploy Blueprint on mediawiki.org as optional and experimental skin
Resolved	• Prtksxna	T99757 Blueprint/LSG Table of Contents should be configurable on-wiki, like MediaWiki:Sidebar
Resolved	• Prtksxna	T103784 The Blueprint sidebar on devhub prototype is missing Discussion link
Resolved	• Prtksxna	T104288 Blueprint skin has no footer or replacement (so no copyright)
Resolved	• Spage	T104672 Convert Blueprint to core's HTML templating
Resolved	Jdlrobson	T97188 Mustache templates in core do not support partials (client side)
Resolved	None	T110988 Blueprint assumes personal_urls[0] contains username
Declined	None	T104673 Remove Blueprint's use of bootstrap
Resolved	None	T107662 Add bootstrap source files with components currently in use at Blueprint
Resolved	Qgil	T104694 Community support for deploying Blueprint in mediawiki.org as optional/experimental skin
Resolved	Volker_E	T109135 Change `#searchInput` to `type="search"` and add `<label>`.
Resolved	• violetto	T112308 Blueprint should include skip-to-nav and skip-to-content links
Resolved	Volker_E	T119444 Integrate CSS mixin for screen reader and keyboard-only users into core
Resolved	Volker_E	T112342 Make Blueprint fully localizable
Declined	None	T112487 Blueprint HTML output lacks headings (document) structure
Resolved	None	T110983 Blueprint sidebar reuses #firstHeading id
Resolved	Volker_E	T107213 Blueprint should make use of HTML5 <header> and <main> element with correct ARIA roles
Declined	None	T113208 Consolidate CSS background images implementation with core mixins or ResourceLoaderImageModule
Resolved	Volker_E	T104213 No icon for "View source" and "Edit" in sidebar
Resolved	Volker_E	T113296 Keyboard selector (IMESelector) not correctly viewed on main search in Blueprint
Resolved	Volker_E	T107026 Cleanup `font` properties and let section edit link `.mw-editsection` use sans-serif font
Resolved	Volker_E	T116722 Align Blueprint to Jenkins' composer.json validation
Resolved	Pastakhov	T114463 Blueprint skin does not render all what it should
Resolved	None	T103452 Blueprint skin does not render page indicators
Resolved	Pastakhov	T116130 "Undefined index: userpage" error when user is logged out
Resolved	None	T117843 The link of sidebar menu is directed to server root instead of wiki homepage
Resolved	Volker_E	T118113 Address FOUC of Toc in Blueprint
Resolved	None	T114212 Do not put the role="search" on the form element
Resolved	Volker_E	T121840 Remove obsolete LivingStyleGuide.php from Blueprint
Resolved	Volker_E	T122117 Bootstrap's CSS rule "box-sizing: border-box;" breaks VE toolbar
Resolved	Volker_E	T122753 Blueprint should use MediaWiki core's Less mixins
Resolved	Qgil	T308 A single Developer Hub plan agreed and documented
Resolved	• Spage	T304 Developer Hub contribution process
Resolved	Qgil	T311 URL of the Developer Hub
Resolved	Qgil	T309 Name for the 'developer hub'
Resolved	Qgil	T312 Technology selection for the Developer Hub
Resolved	None	T310 Requirements for the Developer Hub infrastructure
Declined	None	T322 Possibility to pair API documentation with user comments
Resolved	Qgil	T313 Future of the current Developer Hub at mediawiki.org
Resolved	Dzahn	T372 Redirect dev.wikimedia.org to mediawiki.org
Resolved	Qgil	T565 Recruit a Technical Writer for the Engineering Community team
Resolved	Qgil	T663 Documentation microtasks for newcomers
Resolved	• Rfarrand	T671 Promote the link to this job opening in the MediaWiki social media channels
Resolved	Aklapper	T85485 Create Documentation tag
Resolved	• Spage	T92941 Define personas for dev.wikimedia.org
Resolved	• Spage	T92945 Reflect in dev.wikimedia.org what Wikimedia offers to developers
Resolved	• DannyH	T103049 Enable Flow on Web APIs talk pages on mediawiki.org
Declined	• Spage	T369 Implement a namespace in mediawiki.org to host the developer hub
Declined	None	T105133 Organize current and new content in the API: namespace at mediawiki.org
Declined	None	T93062 Define the navigation elements of the Web APIs hub
Resolved	• Spage	T104282 Goal: Create landing pages for the free open knowledge sources on the Web APIs Hub
Declined	None	T112490 make Web APIs hub a front door to API documentation

Event Timeline

• Spage created this task.Jun 4 2015, 8:44 PM

• Spage claimed this task.

• Spage raised the priority of this task from to Needs Triage.

• Spage updated the task description. (Show Details)

• Spage added projects: Web-APIs-Hub, Epic.

Restricted Application added a subscriber: Aklapper. · View Herald TranscriptJun 4 2015, 8:44 PM

• Spage added subtasks: T301: Define the look&feel of the Developer Hub, T93613: Deploy Blueprint on mediawiki.org as optional and experimental skin, T313: Future of the current Developer Hub at mediawiki.org, T98897: Deploy SkinPerNamespace extension on mediawiki.org.Jun 4 2015, 8:46 PM

• Spage mentioned this in T101100: Engineering Community quarterly goals for July-September 2015.Jun 4 2015, 8:54 PM

• Spage updated the task description. (Show Details)Jun 4 2015, 8:58 PM

• Spage set Security to None.

• Spage added a subtask: T369: Implement a namespace in mediawiki.org to host the developer hub.Jun 4 2015, 9:01 PM

• Prtksxna awarded a token.Jun 5 2015, 5:46 AM

Qgil renamed this task from integrate new Developer hub with mediawiki.org to Integrate new Developer hub with mediawiki.org.Jun 10 2015, 10:00 AM

Qgil triaged this task as Medium priority.

Qgil updated the task description. (Show Details)

Qgil added projects: Developer-Advocacy, ECT-July-2015, ECT-August-2015, DevRel-September-2015, Blueprint.

Qgil updated the task description. (Show Details)

Qgil added subscribers: • violetto, Volker_E, • Prtksxna.

Qgil renamed this task from Integrate new Developer hub with mediawiki.org to Goal: Integrate new Developer hub with mediawiki.org.Jun 10 2015, 10:02 AM

Qgil added a parent task: T101100: Engineering Community quarterly goals for July-September 2015.

Qgil mentioned this in T101099: Developer Relations Roadmap.Jun 10 2015, 12:15 PM

Qgil added subtasks: T305: Developer Hub homepage, T312: Technology selection for the Developer Hub, T308: A single Developer Hub plan agreed and documented, T67074: Set up dev.wikimedia.org portal.Jun 11 2015, 9:22 AM

Qgil mentioned this in T67074: Set up dev.wikimedia.org portal.Jun 11 2015, 9:24 AM

Qgil mentioned this in T322: Possibility to pair API documentation with user comments.Jun 11 2015, 9:27 AM

Qgil mentioned this in T369: Implement a namespace in mediawiki.org to host the developer hub.Jun 11 2015, 9:32 AM

Qgil mentioned this in T91626: Technology to transclude git content into wiki pages.Jun 11 2015, 9:35 AM

Qgil mentioned this in T312: Technology selection for the Developer Hub.Jun 11 2015, 9:43 AM

Qgil closed subtask T312: Technology selection for the Developer Hub as Resolved.

Ricordisamoa subscribed.Jun 11 2015, 9:56 AM

Qgil mentioned this in T313: Future of the current Developer Hub at mediawiki.org.Jun 11 2015, 10:18 AM

Qgil mentioned this in T99757: Blueprint/LSG Table of Contents should be configurable on-wiki, like MediaWiki:Sidebar.Jun 11 2015, 11:03 AM

Qgil mentioned this in T93610: Put WikimediaUI Style Guide on mediawiki.org.Jun 11 2015, 11:11 AM

Qgil mentioned this in T308: A single Developer Hub plan agreed and documented.Jun 11 2015, 11:19 AM

Qgil mentioned this in T302: API sandboxes for the Developer Hub.Jun 15 2015, 12:05 PM

Qgil mentioned this in T103049: Enable Flow on Web APIs talk pages on mediawiki.org.Jun 19 2015, 8:44 AM

Qgil added a subtask: T103049: Enable Flow on Web APIs talk pages on mediawiki.org.

• Spage mentioned this in P840 Data and developer hub announcement.Jun 25 2015, 5:39 AM

• Spage mentioned this in T103986: issues with Data and Developer Hub prototype (tracking).Jun 26 2015, 11:58 AM

• Elitre subscribed.Jun 26 2015, 9:07 PM

Qgil changed the status of subtask T369: Implement a namespace in mediawiki.org to host the developer hub from Open to Stalled.Jun 27 2015, 5:09 PM

Qgil moved this task from To triage to July-September 2015 on the Developer-Advocacy board.Jun 28 2015, 9:56 PM

• Spage mentioned this in T104543: support multiple simultaneous Blueprint sidebar configurations.Jul 2 2015, 7:14 AM

Qgil closed subtask T301: Define the look&feel of the Developer Hub as Resolved.Jul 3 2015, 8:56 AM

• Spage closed subtask T369: Implement a namespace in mediawiki.org to host the developer hub as Declined.Jul 8 2015, 8:54 AM

Qgil closed subtask T313: Future of the current Developer Hub at mediawiki.org as Resolved.Jul 8 2015, 10:05 AM

• Spage closed subtask T305: Developer Hub homepage as Resolved.Jul 28 2015, 5:23 AM

• Spage moved this task from Backlog to Ready to Go on the ECT-July-2015 board.

Qgil renamed this task from Goal: Integrate new Developer hub with mediawiki.org to Goal: Integrate the new Web APIs hub with mediawiki.org.Aug 8 2015, 2:47 PM

Qgil closed subtask T308: A single Developer Hub plan agreed and documented as Resolved.Aug 8 2015, 2:51 PM

Qgil added a subtask: T104282: Goal: Create landing pages for the free open knowledge sources on the Web APIs Hub.Aug 8 2015, 2:53 PM

Qgil removed a subtask: T67074: Set up dev.wikimedia.org portal.Aug 8 2015, 2:56 PM

• Spage moved this task from Backlog to Doing on the ECT-August-2015 board.Aug 11 2015, 4:05 PM

waldyrious subscribed.Aug 12 2015, 12:06 AM

• Spage mentioned this in T110108: IRC office hour to discuss the mw.org API namespace.Aug 24 2015, 8:40 PM

Tuesday 2015-09-01T18:00 UTC (11am San Francisco time) we will be having an IRC office hour about

If you're interested in developing with, documenting, or promoting MediaWiki/Wikimedia APIs, you should attend. I hope by having a realtime conversation we can come to a shared understanding faster.

Qgil mentioned this in T98897: Deploy SkinPerNamespace extension on mediawiki.org.Aug 27 2015, 9:09 AM

• Spage closed subtask T103049: Enable Flow on Web APIs talk pages on mediawiki.org as Resolved.Aug 31 2015, 7:24 PM

• Spage moved this task from Backlog to Doing on the DevRel-September-2015 board.Sep 1 2015, 4:20 PM

• Spage added a subtask: T112490: make Web APIs hub a front door to API documentation.Sep 14 2015, 1:33 AM

• Spage closed subtask T104282: Goal: Create landing pages for the free open knowledge sources on the Web APIs Hub as Resolved.Sep 16 2015, 12:09 AM

@Spage, one measurement of success of this goal is "Community process to propose and contribute documentation". I think you mentioned a wiki page for this, but I cannot find it.

In T101441#1680770, @Qgil wrote:

@Spage, one measurement of success of this goal is "Community process to propose and contribute documentation". I think you mentioned a wiki page for this, but I cannot find it.

https://www.mediawiki.org/wiki/Web_APIs_hub/Contributing