Highlights of findings from content audit so far (full details in Content Strategy (Google Doc)):

Snapshot of analysis from content audit

Main opportunities to improve content structure and findability

Identify sub-collections

[Work in progress, working on this with Olja and others to create a draft IA.]

Add navigation menus

Currently, there's only a nav template for the team docs (which are moving to MediaWiki). The only way to navigate the large corpus of other pages is through the TOC page, which has separate sections based on the legacy team structure, /Analytics and /Data_Engineering.

Status update:

• Finished and shared draft of content strategy (Google Doc) highlighting my findings so far from DPE docs content audit; identified design goals.
• Started co-designing the information architecture for DPE docs on Wikitech; the main goals right now are:
  • Get aligned on the plan for how the docs on Wikitech will be evolving
  • Identify a meaningful set of subcollections that can improve the user experience for the two major audiences: data producers and data consumers.
• Olja and other DPE team leads will meet in the coming days to get aligned on overall docs strategy for Wikitech and team docs on Mediawiki
• Content audit will continue in parallel with planning/design meetings in the coming week.

I've started a draft on-wiki that attempts to start integrating some of the Research-focused learning goals and data user journeys I identified into an outline. Will continue to build on this as we figure out how to structure the content, i.e. as a set of wiki pages and/or a revised version of the Research:Data portal, or something else still TBD: https://meta.wikimedia.org/wiki/User:TBurmeister_(WMF)/Sandbox/Research:Data

Marking this as stalled while we work on improving and migrating the Data Platform docs on Wikitech (T350911), which is a prerequisite for working on the dataset documentation (a subset of the overall Data Platform docs).

@nskaggs we talked about this in our 1:1 on Oct 3 but I still don't have these rights; can you help? Thanks!

Work in this area will proceed in collaboration with the Research and Data Platform Engineering teams as we work on creating new content to help researchers navigate our data landscape, while also coordinating that with changes to the underlying data infrastructure and documentation strategy for that. Details to be worked out in the coming weeks; but at minimum this will include:

• Revising and updating content on https://meta.wikimedia.org/wiki/Research:Data
• Work on https://phabricator.wikimedia.org/T343146

Met with more stakeholders and product owners / directors; determined that the first project to be prioritized in this area is: https://phabricator.wikimedia.org/T350911

Status update: I'm in the research and information-gathering phase, building my understanding of this space and meeting with subject matter experts to try to narrow down priority focus areas so that I can scope project work for this and coming quarters.

• In the past week I had 3 meetings with people from Data Platform Eng, Product Analytics and Data Products; next week I have two more meetings scheduled.
• I read various documents written by data consumers, like this article and this PDF guide written by a Wikimedian in 2012, which, though old, still provides a useful conceptual framework and ideas for how to structure content that introduces data consumers to this topic area.
• I read many wiki pages and project docs, in an attempt to get up to speed on the current status of APP work and other ongoing projects.
• I learned about webrequests and how the pageviews public dataset is generated, and I started modeling and auditing the documentation for this dataset and its sources.
• I learned about the data model behind some of the major tables written by MediaWiki, and started a list of important concepts to make sure data access docs cover for those data sources.

Status update: I'm in the research and information-gathering phase, building my understanding of this space and meeting with subject matter experts to try to narrow down priority focus areas so that I can scope project work for this and coming quarters.

• In the past week I had 3 meetings with people from Data Platform Eng, Product Analytics and Data Products; next week I have two more meetings scheduled.
• I read various documents written by data consumers, like this article and this PDF guide written by a Wikimedian in 2012, which, though old, still provides a useful conceptual framework and ideas for how to structure content that introduces data consumers to this topic area.
• I read many wiki pages and project docs, in an attempt to get up to speed on the current status of APP work and other ongoing projects.
• I learned about webrequests and how the pageviews public dataset is generated, and I started modeling and auditing the documentation for this dataset and its sources.
• I learned about the data model behind some of the major tables written by MediaWiki, and started a list of important concepts to make sure data access docs cover for those data sources.

Useful resource: https://www.w3.org/TR/vocab-dcat/

Since Technical Engagement no longer exists as a team / department, marking this as Declined.

In July 2023 I rewrote https://www.mediawiki.org/wiki/Documentation/Contribute/Filing_documentation_tasks. Future work on this topic will be handled under Tech Docs team projects: https://www.mediawiki.org/wiki/Wikimedia_Technical_Documentation_Team

On-wiki summary of landing pages to which the Developer Portal links, and my attempt to identify the organizing principle behind them:
https://www.mediawiki.org/wiki/User:TBurmeister_(WMF)/Sandbox/Landing_page_analysis

https://wikitech.wikimedia.org/wiki/Wikimedia_Cloud_Services_team/Documentation_guide

The Cloud-Services project tag is not intended to have any tasks. Please check the list on https://phabricator.wikimedia.org/project/profile/832/ and replace it with a more specific project tag to this task. Thanks!

Project summary slides on Commons: https://commons.wikimedia.org/wiki/File:Cloud_Docs_Project_Summary_Q1_FY2023-24.pdf

Project summary slides (Google slides link accessible to WMF only, I will create a public version on Commons when I start my workday tomorrow).