User:TBurmeister (WMF)/Sandbox/DevPortal
 | This page is obsolete. It is being retained for archival purposes. It may document extensions or features that are obsolete and/or no longer supported. Do not rely on the information here being up-to-date. |
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
[edit]- 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
[edit]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
[edit]Learn how Wikimedia software projects work
[edit]Browse tutorials
[edit]Learn about Wikimedia technology
[edit]Explore open source projects
[edit]- MediaWiki**
- Wikibase**
- Wikipedia for Android**
- Offline reading projects**
- Cloud tools and services
- Technical decision making process
- Search the codebase
Set up developer accounts
[edit]Choose your goal and start coding
[edit]Use Wikimedia content or data in your project
[edit]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.
Browse web APIs
[edit]Learn with API tutorials
[edit]Reuse wiki content
[edit]- 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
[edit]- 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
[edit]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.
Discover tools on Toolhub
[edit]Learn about MediaWiki extension points
[edit]Change MediaWiki behavior and appearance
[edit]- 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
[edit]- Create scripts or bots that interact with MediaWiki pages
- Use ML to detect vandalism
- Use APIs to support editing
Extend and customize MediaWiki functionality
[edit]- Browse extensions
- Write new extensions
- Improve or maintain extensions
- Extensions FAQ
Host tools on Toolforge
[edit]Contribute to Wikimedia open source
[edit]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
[edit]- Contribute to Wikimedia software
- Contribute to MediaWiki and MediaWiki extensions
- Code of conduct
Projects for new contributors
[edit]Featured Wikimedia open source projects
[edit]- MediaWiki**
- Wikibase**
- Wikipedia for Android**
- Offline reading projects**
Localization
[edit]Documentation
[edit]Accessibility
[edit]Connect with the tech community
[edit]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.
Explore hackathons & events
[edit]Communicate effectively
[edit]- Communication channels
- Code of conduct
Find code maintainers
[edit]Be a tech ambassador
[edit]Apply for grants
[edit]Wikimedia Foundation technical operations
[edit]- Cloud services
- Technical infrastructure
- Software deployments
- Performance monitoring
- Security policies
- System architecture
Get tech project updates
[edit]- Wikimedia tech news
- Technical community newsletter
- Tech blog
- Technical decision records
Grow your technical skills
[edit]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.