Identify documentation pages popular on desktop and mobile, and review these pages to ensure they display correctly on mobile devices.
Focus on Recommendations for mobile friendly articles on Wikimedia wikis, but also take ideas from Adaptable UX to various devices into account.
Rationale
As per Wikimedia Statistics, mobile devices generated 22-50% of monthly page views on mediawiki.org in 2024 (average of 33%). It's important to ensure our documentation is as readable and usable on mobile devices as it is on desktop.
Outcome
- Reviewed around 140 of the most popular pages on mediawiki.org and Wikitech.
- Identified and fixed the most common mobile readability issues via:
- Changes to message box styles on mediawiki.org
- Change to the caution template on mediawiki.org
- Changes to code snippets, tables, and general styles of page elements on mediawiki.org and Wikitech
- Added a short section about readability on mobile devices to Documentation/Style guide.
Plan
- Identify pages to review
- Review and fix the identified pages, improve or create new templates where necessary
- Write down documentation-focused good practices for mobile readability