Page MenuHomePhabricator
Create Task
Maniphest T105133

Organize current and new content in the API: namespace at mediawiki.org
Closed, DeclinedPublic
Actions

Description

Now that we have decide that Web-APIs-Hub must be integrated with the API: namespace at mediawiki.org, we need to plan a good organization of the new content with the existing content (basically the documentation of api.php action API for any MediaWiki installation).

For a good integration, we need

Related Objects
Search...

Event Timeline

Qgil created this task.Jul 8 2015, 10:21 AM
Qgil raised the priority of this task from to Medium.
Qgil updated the task description. (Show Details)
Qgil added projects: Web-APIs-Hub, Documentation.
Qgil added subscribers: Qgil, • Spage, Anomie, waldyrious.
Restricted Application added a subscriber: Aklapper. · View Herald TranscriptJul 8 2015, 10:21 AM
Qgil mentioned this in T93613: Deploy Blueprint on mediawiki.org as optional and experimental skin.Jul 8 2015, 10:39 AM
Ricordisamoa subscribed.Jul 8 2015, 11:15 AM
• Spage claimed this task.Aug 3 2015, 9:25 PM
• Spage raised the priority of this task from Medium to High.
• Spage added a project: ECT-August-2015.
Qgil added a subtask: T93062: Define the navigation elements of the Web APIs hub.Aug 4 2015, 10:21 AM
Qgil mentioned this in T98897: Deploy SkinPerNamespace extension on mediawiki.org.Aug 4 2015, 10:29 AM
• Spage added a comment.EditedAug 10 2015, 9:34 AM

My plan:

  • API:Main_page becomes API:PHP action API (or whatever the bike shedding results in).
  • API:Web APIs hub gets a little more information so it can guide users to the various APIs.
    • Then I think it can serve as a general-purpose introduction, and definitely the one in How to contribute.
    • This pictures-and-less-wordy "Showcase-Explore-Build" is a little "adventurous" for mediawiki.org, but much existing content will continue to link to the PHP action API main page.
  • the Table of contents navigation drawn by Template:API could straddle both the general APIs and the specific PHP action API pages (see this rev).
    • eventually have to figure out how to handle in Blueprint
Qgil added a comment.Aug 10 2015, 9:58 AM

Just to be clear, "API:Web APIs hub" will be the new main page of the namespace, right?

Ricordisamoa added a comment.Aug 10 2015, 12:55 PM
In T105133#1523591, @Spage wrote:

API:Main_page becomes API:PHP action API (or whatever the bike shedding results in).

To a third-party developer "PHP action API" could mean it can only be used from PHP.

• Spage added a comment.Aug 10 2015, 8:53 PM
In T105133#1523611, @Qgil wrote:

Just to be clear, "API:Web APIs hub" will be the new main page of the namespace, right?

Effectively. I don't know that "API:Main_page" is special. mw:API redirects to it. I will identify links to existing main page and decide if their intent is Web APIs in general or the PHP action API.

In T105133#1523845, @Ricordisamoa wrote:
In T105133#1523591, @Spage wrote:

API:Main_page becomes API:PHP action API (or whatever the bike shedding results in).

To a third-party developer "PHP action API" could mean it can only be used from PHP.

Yes, not perfect but can we improve it? (MediaWiki) "action API" sounds pretty cool actually. I left out the link to bikeshedding in this wikitech-l thread.

Ricordisamoa added a comment.Aug 11 2015, 12:18 AM
In T105133#1525476, @Spage wrote:
In T105133#1523845, @Ricordisamoa wrote:

To a third-party developer "PHP action API" could mean it can only be used from PHP.

Yes, not perfect but can we improve it?

https://lists.wikimedia.org/pipermail/wikitech-l/2015-August/082699.html

• Spage moved this task from Backlog to Ready to Go on the ECT-August-2015 board.Aug 11 2015, 4:04 PM
• Spage moved this task from Ready to Go to Doing on the ECT-August-2015 board.
• Spage mentioned this in T110108: IRC office hour to discuss the mw.org API namespace.Aug 24 2015, 8:40 PM
Qgil added a comment.Aug 27 2015, 9:08 AM

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 T101441: Goal: Integrate the new Web APIs hub with mediawiki.org.Aug 27 2015, 9:09 AM
• Spage added a comment.Aug 31 2015, 8:54 PM

In API_talk:Main_page I propose renaming API:Main_page to "API:Introduction to the action API". I've also tweaked the navigation template.

Qgil added a project: DevRel-September-2015.Sep 1 2015, 4:20 PM
• Spage moved this task from Backlog to Doing on the DevRel-September-2015 board.Sep 15 2015, 6:32 PM
Qgil added a project: DevRel-October-2015.Oct 7 2015, 1:33 PM
• Spage lowered the priority of this task from High to Medium.Oct 13 2015, 6:18 PM

Lowering priority, as "How to contribute" links to new Web APIs hub and it's in the action API navigation.

Aklapper removed • Spage as the assignee of this task.Sep 23 2016, 2:11 PM
• srodlund moved this task from Backlog to API Documentation Request on the Documentation board.Aug 15 2018, 12:41 AM
Aklapper closed this task as Declined.Oct 7 2019, 11:17 AM

The Web-APIs-Hub project is dead hence mass-declining its tasks to reflect reality. It might be superseded by a Developer Portal in the future.

Aklapper closed subtask T93062: Define the navigation elements of the Web APIs hub as Declined.Oct 7 2019, 11:17 AM
Aklapper removed a subscriber: Anomie.Oct 16 2020, 5:28 PM
Content licensed under Creative Commons Attribution-ShareAlike (CC BY-SA) 4.0 unless otherwise noted; code licensed under GNU General Public License (GPL) 2.0 or later and other open source licenses. By using this site, you agree to the Terms of Use, Privacy Policy, and Code of Conduct. · Wikimedia Foundation · Privacy Policy · Code of Conduct · Terms of Use · Disclaimer · CC-BY-SA · GPL · Credits