User:TBurmeister (WMF)/Sandbox/DevPortal

See the live site structure at developer.wikimedia.org and more information at Developer portal: Content_strategy#Information_architecture

---

This doc proposes a set of high-level user goals -- or "critical user journeys" -- to be used as the top-level organizing framework for v4 of the Developer Portal. This proposal is based on previous work, including but not limited to: user personas and motivations, dev portal prototype v0-v3, and user research.

Each user journey proposed will be a top-level section in v4 of the Developer Portal. The rest of this doc outlines:

• Methodology for designing this information architecture
• Which user personas and v3 portal contents map to the newly-proposed sections

This page partially outlines the IA, but for easier iteration and feedback the full content is temporarily in this Google doc. See that doc for:

• Proposed subsections for each section
• Proposed Wiki content links for each subsection

Methodology

• Used an open cardsorting approach to identify user goals from existing content descriptions from dev portal prototype v3.
• Mapped user persona motivations to high-level user goals.
• Reviewed Special:MostLinkedPages, Special:MostInterwikis, and Special:MostRevisions to identify frequently-used and important docs, and ensure that they would have a sensible home in the new structure.
• Reviewed existing content hubs (especially Developer_hub and its talk page) to ensure key links are represented prominently in the new structure.
• Reviewed and incorporated previous work and ideas like that at User:Waldyrious/Docs.
• Reviewed findings from in-person user interviews to align high-level sections with observed user behavior and expectations.

Proposed sections and what they cover

The following sections outline how each of the the proposed user journeys -- which are the top-level elements for the developer portal navigation -- cover the previously-identified user persona motivations and content elements of developer portal prototype (v3).

Note: headings followed by two asterisks (**) are single-sourced sections that appear in more than one location.

Get started

Explore open source projects

• MediaWiki**
• Wikibase**
• Wikipedia for Android**
• Offline reading projects**
• Cloud tools and services
• Technical decision making process
• Search the codebase

Use Wikimedia content or data in your project

Persona motivations and existing prototype content covered by this section

User persona motivations:

• Use Wikimedia content in my app
• Use an example dataset for data science purposes.
• Use data from Wikimedia as part of my research.
• Use data to understand my wiki, Wikimedia projects, and Wikimedia users

v3 prototype links:

• Access content databases for Wikimedia project.
• Access data from Wikidata.
• Access Wikipedia without internet access.
• Browse Wikimedia APIs
• Download all Wikimedia projects for backup, offline use, research, and more.
• Explore Wikimedia project data.
• Fetch pages from Wikipedia, Wiktionary, Wikivoyage, and more.
• Find articles in Wikipedia, images in Commons, and more.
• Get data from Wikidata with the SPARQL query endpoint.
• Get daily featured articles, most read pages, and more.
• Get page view data for Wikimedia projects.
• Get the number of unique devices accessing Wikimedia projects.
• Get Wikidata, page views, edit scores, and more data from Wikimedia projects.
• Get mobile-friendly content, featured article feeds, pageview data, and more.
• Get pages by title on any Wikimedia project.
• Get pages in mobile format.
• Monitor the current and past performance of Wikimedia sites.
• Review recent changes, and monitor content
• Learn to use the MediaWiki Action API Geosearch module
• Learn to use the MediaWiki Action API Images and Imageinfo modules
• Retrieve and present relevant information from Wikidata by associating it with entities in my application.
• Use MediaWiki Action API
• Use MediaWiki REST API
• Use Event Streams API to get the most recent changes to Wikimedia projects.

Reuse wiki content

• Get featured content by date
• Search for and display wiki pages and media
• Parse wikitext page content
• Get pages in mobile format
• Get data from Wikidata with SPARQL

Access data and analyze wikis

• Use Wikimedia open data sources
• Get data about wikis
• Get data dumps
• Query content databases
• Use machine learning to detect vandalism
• Get a stream of recent changes
• Access structured knowledge on Wikidata
• Explore project data on WikiStats

Build and discover tools

Persona motivations and existing prototype content covered by this section

User persona motivations:

• Improve a tool (mine or someone else's)
• Share something cool that I built
• Solve a problem on my local wiki
• Download Wikimedia content to use in an offline app or to host a mirror

v3 prototype links:

• Add context when searching for Wikipedia pages using the MediaWiki Action API.
• Create bots that automate editing and wiki maintenance.
• Edit pages from Wikipedia, Wiktionary, Wikivoyage, and more.
• Find and share tools on Toolhub.
• Get the latest updates, and connect with tool developers
• Guide editors by suggesting places in an article where a link could be added.
• Host your tools with Toolforge.
• Suggest images to improve articles
• Adapt code to different languages and regions.
• Add or remove pages from a watchlist.
• Create and edit pages.
• Create bots that automate editing and wiki maintenance.
• Learn to use the MediaWiki Action API Parse and Links modules
• Use machine learning to detect vandalism.

Change MediaWiki behavior and appearance

• Change the appearance of MediaWiki with skins
• Add JavaScript or CSS gadgets to a wiki
• Add scripting to wiki pages through templates

Automate editing and maintenance

• Create scripts or bots that interact with MediaWiki pages
• Use ML to detect vandalism
• Use APIs to support editing

Extend and customize MediaWiki functionality

• Browse extensions
• Write new extensions
• Improve or maintain extensions
• Extensions FAQ

Contribute to Wikimedia open source

Persona motivations and existing prototype content covered by this section

User persona motivations:

• Contribute to a Wikimedia open source project
• Contribute to Wikimedia docs.
• Create documentation for a new Wikimedia project.
• Improve the Wikimedia technical documentation that I use.
• Learn about our tech stack and systems
• Translate docs into my language.
• Translate interfaces into my language.

v3 prototype links:

• Explore Wikimedia open source code bases.
• Find resources for writing and maintaining technical docs.
• Learn about the infrastructure behind Wikimedia projects.
• Read security policies for the MediaWiki platform and the Wikimedia Foundation.
• Understand best practices for writing code for Wikimedia software.
• Find maintainers and code stewards for Wikimedia open source software.

Learn how contributing works

• Contribute to Wikimedia software
• Contribute to MediaWiki and MediaWiki extensions
• Code of conduct

Featured Wikimedia open source projects

• MediaWiki**
• Wikibase**
• Wikipedia for Android**
• Offline reading projects**

Connect with the tech community

Persona motivations and existing prototype content covered by this section

User persona motivations:

• Find out what other people and teams are working on.
• Connect with other technical contributors
• Figure out who is responsible for something/who I can talk to about a specific topic or technology.
• Mentor outreach participants.
• Share something cool that I built

v3 prototype links:

• Get a stream of the latest changes to Wikimedia projects.
• Learn about why and how technical decisions are made.
• Stay up to date with the latest updates.
• Subscribe to the mailing list for notifications of breaking changes and other important announcements.
• Track software deployments to Wikimedia Foundation servers.
• Apply for a grant to improve software or conduct research.
• Discussion related to the MediaWiki API and its ongoing development
• Explore content from past hackathons or join us for an upcoming event.
• Find maintainers and code stewards for Wikimedia open source software.
• Find out about internships and mentoring opportunities with Wikimedia.
• Get the latest updates, and connect with tool developers
• Join the offline projects user group.
• Understand the principles we follow to foster a welcoming community.

Communicate effectively

• Communication channels
• Code of conduct

Wikimedia Foundation technical operations

• Cloud services
• Technical infrastructure
• Software deployments
• Performance monitoring
• Security policies
• System architecture

Get tech project updates

• Wikimedia tech news
• Technical community newsletter
• Tech blog
• Technical decision records

Grow your technical skills

Persona motivations and existing prototype content covered by this section

User persona motivations:

• Grow my technical skills
• Learn about and apply for outreach programs.

v3 prototype links:

• Explore content from past hackathons or join us for an upcoming event.
• Find out about internships and mentoring opportunities with Wikimedia.
• Explore system architecture documentation.

Get help