⚓ T299087 Finalize dev portal content and structure: "Connect" section
Page MenuHomePhabricator

Finalize dev portal content and structure: "Connect" section
Closed, ResolvedPublic

Description

  • Review content and compare with on-wiki content to identify potential coverage gaps.
  • Interview and collaborate with SMEs in each area to identify key user tasks and potential gaps in portal content.
  • Update site structure and content, confirm correct sequencing for content on each page.
  • Complete task-completion-focused UXR (tracked in T286087 and related).
  • Review and finalize all copy.

[skip - this will be done en masse later / soon] Add any docs not already included in the Key Docs list to the schedule for doc review.

  • Resolve all TODOs in markdown files.

Notes

Docs to consider including

Event Timeline

Spreadsheet cleaning notes re: content coverage: the following links were included in a previous prototype or key doc list and aren't included in the current version of the portal. This may be okay, but should be a conscious decision:

https://lists.wikimedia.org/hyperkitty/list/mediawiki-api-announce@lists.wikimedia.org/
https://lists.wikimedia.org/postorius/lists/mediawiki-api.lists.wikimedia.org/
https://www.mediawiki.org/wiki/Special:MyLanguage/Developer_hub

In my understanding, general mailing lists (whether for support or for announcements) are linked from https://www.mediawiki.org/wiki/Communication ; these two specific API related mailing lists could be worth to add to https://www.mediawiki.org/w/index.php?title=Template:API assuming they are about the MW Action API and assuming these lists were actually active and used and watched by potential maintainers.
Looking at https://www.mediawiki.org/wiki/API:Main_page#Code_stewardship these lists are not even mentioned.
Looking at https://lists.wikimedia.org/hyperkitty/list/mediawiki-api-announce@lists.wikimedia.org/latest , latest posts are one post in June 2021, one post in June 2020, one post in April 2020, two in February 2020. Seems pretty dead.
https://lists.wikimedia.org/hyperkitty/list/mediawiki-api@lists.wikimedia.org/latest does not look impressively active either.

I don't see how https://www.mediawiki.org/wiki/Developer_hub would end up under "Connect".

I don't see how https://www.mediawiki.org/wiki/Developer_hub would end up under "Connect".

I had to put it in one of these bugs and this was the best one I could think of :)

TBurmeister changed the task status from Open to In Progress.Jan 25 2022, 9:33 PM

Add Data Reuse Days to the "events" subpage, since this is relevant for developers who are reusing wiki data in their apps. https://www.wikidata.org/wiki/Wikidata:Events/Data_Reuse_Days_2022

Change 771365 had a related patch set uploaded (by Triciaburmeister; author: Triciaburmeister):

[wikimedia/developer-portal@main] content: combine 'Grow' and 'Connect' sections

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

If the previous link was intentionally for testing it makes sense; if not its production/live instance is at https://diff.wikimedia.org/calendar/

Change 779132 had a related patch set uploaded (by Triciaburmeister; author: Triciaburmeister):

[wikimedia/developer-portal@main] content: Add events and reorder items on the events page

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

Change 779132 merged by jenkins-bot:

[wikimedia/developer-portal@main] content: Add events and reorder items on the events page

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

Change 784325 had a related patch set uploaded (by Triciaburmeister; author: Triciaburmeister):

[wikimedia/developer-portal@main] content: Add Mediawiki events to Connect section

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

Change 784325 merged by jenkins-bot:

[wikimedia/developer-portal@main] content: Add Mediawiki events to Connect section

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

Change 789624 had a related patch set uploaded (by Triciaburmeister; author: Triciaburmeister):

[wikimedia/developer-portal@main] content: finalize copy and content for Connect section

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

Change 789624 merged by jenkins-bot:

[wikimedia/developer-portal@main] content: finalize copy and content for Connect section

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