Good first bugs



This page provides a list of little bugs and tiny missing features which annoy users and which are relatively easy for a mw-hacker>Special:MyLanguage/How to become a MediaWiki hacker|new MediaWiki coder to fix.

This is one way to start getting familiar with the MediaWiki code base.

Note that these tasks to not have assigned mentors so you will be more "on your own". If you prefer to work on software projects with mentors, NewDevs>Special:MyLanguage/New Developers|check out the list of software projects that we recommend.

You must have read the "Set up your development environment" and "Suggested reading" sections of Setup>Special:MyLanguage/How to become a MediaWiki hacker#dev-environment|How to become a MediaWiki hacker already to understand the infrastructure, workflows and communication expectations.

Potential bugs to work on
The following sections describe a few example areas in which you can contribute, but you are not limited to these areas!

In the upper right corner of a task (bug report) in Phabricator you can see the product and component that the problem is located in.

This provides you a hint about the Git repository that the code is located in, and about the development team which you could contact if you want to discuss it in a "broader" way (as comments in bug reports should preferably refer to the specific problem described in the report only).

Documentation
List of open bug reports and enhancement requests related to documentation with the "easy" keyword ]]'''
 * '''[[phab:maniphest/query/bmPJ8iXpC3.C/#R|

Pywikibot
PyWikibot>Special:MyLanguage/Manual:Pywikibot|PyWikibot is a Python-based framework to write bots for MediaWiki.

Ask your general development questions on the mailinglist>mail:pywikipedia-l|Pywikibot mailing list and the IRC>Special:MyLanguage/MediaWiki on IRC|#pywikibot IRC channel.

List of open easy Pywikibot bug reports and enhancement requests ]]'''
 * '''[[phab:maniphest/query/Ti2w8jl2dQE5/#R|

Multimedia
Ask your general multimedia>Reading/Multimedia|Multimedia development questions on the mail-mm>mail:multimedia|multimedia mailing list and the IRC>Special:MyLanguage/MediaWiki on IRC|#wikimedia-multimedia IRC channel.

List of open easy Multimedia bug reports and enhancement requests ]]'''
 * '''[[phab:maniphest/query/K.5Y3b8fbZbn/#R|

Mobile Apps
There are numerous applications for mobile devices (Android, iOS, Windows Phone, …) to access Wikimedia wikis.

Apps>Wikimedia Apps/Team/Wikipedia Android app hacking|Read the general development information and ask your questions on the email>mail:mobile-l|Mobile mailing list and the IRC>Special:MyLanguage/MediaWiki on IRC|#wikimedia-mobile IRC channel.

List of open easy Mobile applications bug reports and enhancement requests ]]'''
 * '''[[phab:maniphest/query/05.a5v7wlZxm/#R|

Reading
The reading>Reading/Web|reading team builds the software that serves our readers.

We also manage the mobile web experience.

Information>Reading/Web/Team|Read the general development information and ask your questions on the email>mail:mobile-l|Mobile mailing list and the IRC>Special:MyLanguage/MediaWiki on IRC|#wikimedia-mobile IRC channel.

List of open easy reading web tasks ]]'''
 * '''[[phab:maniphest/query/UGGuypsToMqQ/|

Wikidata
Wikidata is a centralized knowledge base for structured data, such as interwiki references and statistical information.

Ask your general development questions on the email>mail:wikidata-l</>|Wikidata mailing list, the IRC>Special:MyLanguage/MediaWiki on IRC</>|#wikidata IRC channel and on the team>wikidata:Wikidata:Contact the development team</>|wiki.

List of open easy Wikidata bug reports and enhancement requests ]]'''
 * '''[[phab:maniphest/query/zH.SGfhpQyC4/#R|

Huggle
Huggle>meta:Huggle</>|Huggle is a desktop application for dealing with vandalism on Wikimedia projects, written in C++ and QT.

List of open easy Huggle bug reports and enhancement requests ]]'''
 * '''[[phab:maniphest/query/zZ8QQy8yH1R2/#R|

Browser Tests & Quality Assurance
Automated browser tests help Wikimedia engineers produce quality user facing software faster.

See the page on BrowserTesting>Quality Assurance/Browser testing</>|Browser testing for more on what technologies we use and how to get involved.

For more general information, see QualityAssurance>Quality Assurance</>|Quality Assurance.

List of open easy Browser Test bug reports and enhancement requests ]]'''
 * '''[[phab:maniphest/query/0Q30Z2TNOXDU/#R|

Language Engineering (Localization/Translation/Internationalization)
Ask your general Language>Wikimedia Language engineering</>|Language Engineering development questions on the email>mail:mediawiki-i18n</>|mediawiki-i18n mailing list and the IRC>Special:MyLanguage/MediaWiki on IRC</>|#mediawiki-i18n IRC channel.

List of open easy Language Engineering bug reports and enhancement requests ]]'''
 * '''[[phab:maniphest/query/lfW76SqWto3z/#R|

VisualEditor and Parsoid
VE>VisualEditor</>|VisualEditor is MediaWiki's WYSIWYG>WYSIWYG editor</>|WYSIWYG editor.

Ask your general VisualEditor development questions on the email>mail:wikitech-l</>|wikitech mailing list and the IRC>Special:MyLanguage/MediaWiki on IRC</>|#mediawiki-visualeditor IRC channel.

List of open easy VisualEditor bug reports and enhancement requests ]]'''
 * '''[[phab:maniphest/query/4jbNe9zXNG2a/#R|

VisualEditor is powered by Parsoid>Parsoid</>|Parsoid, a wikitext parser and runtime.

Ask your general Parsoid development questions on the email>mail:wikitext-l</>|wikitext mailing list and the IRC>Special:MyLanguage/MediaWiki on IRC</>|#mediawiki-parsoid IRC channel.

List of open easy Parsoid bug reports and enhancement requests ]]'''
 * '''[[phab:maniphest/query/DXzLdrHdBk4d/#R|

Discovery / Search
The Discovery>Discovery</>|Discovery team builds the path of anonymous discovery to a trusted and relevant source of knowledge.

Ask your general development questions on the email>mail:discovery</>|Discovery mailing list and on the IRC>Special:MyLanguage/MediaWiki on IRC</>|#wikimedia-discovery IRC channel.

List of open easy Discovery / Search bug reports and enhancement requests ]]'''
 * '''[[phab:maniphest/query/qW51XhCCd8.7/#R|

Analytics
The Analytics>Analytics</>|Analytics team empowers and supports data-informed decision making in Wikimedia.

Ask your general development questions on the email>mail:analytics</>|Analytics mailing list.

List of open easy Analytics bug reports and enhancement requests ]]'''
 * '''[[phab:maniphest/query/rKiAEoHQruRE/#R|

Design
Fixing design bugs or requests requires existing graphics skills working with a Vector graphics application (e.g. Inkscape).

Basic knowledge of CSS can also be helpful for integration.

Ask your general development questions on the email>mail:design</>|Design mailing list and the IRC>Special:MyLanguage/MediaWiki on IRC</>|#wikimedia-design IRC channel.

List of open easy design bug reports and enhancement requests ]]'''
 * '''[[phab:maniphest/query/_xoOHrMKoJ8m/#R|

Skins
Skins>Special:MyLanguage/Manual:Skins</>|Skins allow users to customize the look and feel of MediaWiki.

Basic knowledge of CSS and PHP is helpful.

Check the project page in Phabricator for more information on each skin and contact information.

List of open easy skin bug reports and enhancement requests ]]'''
 * '''[[phab:maniphest/query/baZ2C7i31hkV/#R|

System messages and localization/translation problems
System messages in MediaWiki or its extensions often need small corrections to the English text, but the source text can only be changed in the code by developers, contrary to translations.

This has grown into a large backlog of usually very easy fixes (which might be as easy as fixing a typo).

Also, many messages are unclear and require better documentation (see Localisation>Localisation#Message documentation</>|message documentation).

Missing documentation can also be added by just editing the <tvar|qqq> </> subpage of the message on <tvar|TWN>translatewiki.net</>, like all translations, but may require some study of the code to understand what a message is for: it's therefore optimal to start understanding the code, and very useful for the translators (who do not have such skills).

List of open string change bug reports and enhancement requests ]] (under "Blocked by")'''
 * '''[[phab:T40638|

Global Collaboration
The GC>Global Collaboration</>|Global Collaboration team mainly works on Notifications>Notifications</>|Notifications, ERI>New filters for edit review</>|New filters for edit review and SD>Structured Discussions</>|Structured Discussions.

Ask questions regarding GC>Global Collaboration</>|Global Collaboration team projects on the IRC>Special:MyLanguage/MediaWiki on IRC</>|#wikimedia-collaboration IRC channel.

List of open easy Collaboration team bug reports and enhancement requests ]]'''
 * '''[[phab:maniphest/query/DGGB3r4qdur3#R|

MediaWiki
MediaWiki is the core software which provides basic wiki functionality.

It is complex, written in PHP, and some areas might not have clear maintainership.

Ask your general development questions on the email>mail:wikitech-l</>|wikitech mailing list and the IRC>Special:MyLanguage/MediaWiki on IRC</>|#wikimedia-dev and #mediawiki IRC channels.

List of open easy MediaWiki bug reports and enhancement requests ]]'''
 * '''[[phab:maniphest/query/CZe9PaTP.aVy/#R|

Phlogiston
phab>Special:MyLanguage/Phabricator</>|Phabricator is used by Wikimedia for project management, software bug reporting and feature requests.

phlog>Phlogiston</>|Phlogiston is a set of SQL, Python, and R scripts to report on Phabricator data, particularly burnup reports and forecasting.

List of open easy Phlogiston bug reports and enhancement requests ]]
 * [[phab:project/board/1796/query/CUdtv7rO0Rkw/|

Semantic MediaWiki
Semantic MediaWiki is one of the biggest and most popular MediaWiki extensions.


 *  List of SMW issues suitable for newcomers 

And many more…
Still not enough ideas? There are more fields you can explore - MediaWiki has hundreds of extensions and tools! Check out the complete list of bugs recommended for new contributors:

List of open easy bug reports and enhancement requests ]]'''
 * '''[[phab:maniphest/query/77grtOAqxCDa/#R|

If you have any trouble or questions, please ask for help IRC>Special:MyLanguage/MediaWiki on IRC</>|via IRC or feel free to contact <tvar|SSethi>Srishti Sethi</> or <tvar|Aklapper>Andre Klapper</>.