- 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.
- Add any docs not already included in the Key Docs list to the schedule for doc review.
- Resolve all TODOs in markdown files.
Notes
Proposed structure
- Toolhub (single link)
- Get started (get-started-tools)
- Create a Wikimedia account
- About Wikimedia accounts
- Log in to PAWS
- About PAWS
- Pywikibot+PAWS tutorial
- About Pywikibot
- Tutorials (tutorials-tools)
- Any tutorials related to tool building
- APIs and frameworks (apis-tools)
- Pywikibot
- Action API
- Browse client libraries by programming language
- --> Data sources page under use-content/
- --> API catalog page under use-content/
- Hosting (toolforge)
- Create developer account
- Toolforge quick start
- Toolforge landing page
- Best practices (best-practices-tools)
- Creating a bot (mediawiki.org)
- Developing successful tools (Wikitech)
Tasks
- Visual content or data (-->content reuse journey)
- In bulk
- Edit wiki pages
- Edit Wikidata
- Automate to run as a bot
Subjourney: Find a tool
- Visit Toolhub
- Search
- Browse by coolest
- Browse by tag
- Browse by user-created list
- Find tool
- Follow link to tool docs —>
- Doesn't find tool
- —>Build a tool journey
- Find tool
Key docs:
- Toolhub
Subjourney: Request a tool
Excluding this from the Dev Portal for now due to high barriers to entry and low activity
- Request a tool
- Go to Phabricator
- Create account
- Log in
- Create task
- Set up email notifications
- Wait to receive response
- …
- Wait to receive response
- Set up email notifications
- Create task
- Log in
- Create account
- Go to Phabricator
Key docs:
- Create Phabricator account
- Request tool project page in Phabricator
- Template to create a task with the request tool tag
Subjourney: Build a tool
Build a tool: Shortest path to edit a wiki page with code
- Create a Wikimedia global account
- Log in to PAWS
- Create a Python 3 notebook
- Configure, write, and run a pywikibot script
- Create a Python 3 notebook
- Log in to PAWS
Key docs:
- Create a Wikimedia account page
- About Wikimedia accounts
- PAWS login page
- Pywikibot+PAWS tutorial
Build a tool: High-level journey
- Choose a programming language and toolset
- Choose an open source license
- Write the code
- Write the docs
- Share the tool
- Publish the code
- Set up hosting (Toolforge)
- Automate to run as a bot, if appropriate
- Join the community
- Recruit co-maintainers
- Contribute to other tools
- —>Build another tool
- Share the tool
- Choose an open source license