New Developers/fa

This page explains how to get started as a developer who wants to contribute to Wikimedia technical projects.



خوش آمدید
Wikimedia's technical community always welcomes new contributors!

بخشی از یک جامعه جهانی شوید و کمک کنید تا دسترسی به دانش رایگان برای همه آسان تر شود!

How to start contributing
The following steps are a general outline of how to get started contributing:

یک کار را انتخاب و حل کنید (کد خود را بنویسید و آزمایش کنید) به منظور مرور،‌ تغییرات کد خود را ثبت کنید. Follow the Guide to getting your code reviewed and submit a patch.
 * 1) Learn the basics of how Wikimedia open source software projects work.
 * 2) Read the Communication guidelines.
 * 3) Set up accounts: Create a developer account. Depending on the type of contribution you want to make, you may also need to set up accounts in Phabricator, and set up Git and Gerrit.
 * 1) Choose a software project.

The rest of this guide provides additional details about the process.

Basics of how Wikimedia software projects work
Wikimedia has software projects in.

نگهدارندگان پروژه‌های نرم‌افزاری، زیرساختی را که تمایل دارند،‌ انتخاب می‌نمایند. به طور کلی، اکثر پروژه‌های نرم‌افزاری شامل موارد زیر می‌باشند:


 * a task tracking tool where software bugs and enhancement requests are reported, managed and discussed. Examples are Wikimedia Phabricator, GitHub, or Wikimedia GitLab.
 * یک "مخزن کد" که در آن می توان کد منبع را برای همه "بررسی" کرد. به عنوان مثال می توان به Wikimedia Git/Gerrit، GitHub یا Sourceforge اشاره کرد.
 * یک ابزار "بازبینی کد" که در آن تغییرات کد پیشنهادی (به اصطلاح "وصله‌های") مورد بحث و بهبود قرار می‌گیرد. به عنوان مثال می توان به Wikimedia Git/Gerrit، GitHub یا Sourceforge اشاره کرد. هنگامی که پچ پیشنهادی شما خوب شد و در مخزن کد ادغام شد، تغییرات کد شما برای همه در دسترس خواهد بود. (شما می‌توانید درباره شیوه‌های خوب برای بازبینی کد اینجا بیشتر بخوانید.)
 * "مکان های بحث" کلی پروژه نرم افزار و/یا برای دریافت کمک و پشتیبانی. این مکان ها می توانند لیست های پستی یا کانال های چت IRC یا صفحات ویکی یا مکان های دیگر باشند. مکان های دقیق به هر پروژه بستگی دارد. همچنین می توانید از طریق "$1" در صفحات کاربری آنها با مربیان خاصی تماس بگیرید، اما توجه داشته باشید که "سؤالاتی که به صورت خصوصی پرسیده می شوند به دیگران کمک نمی کنند".

در هر زمانی، اگر به مشکل برخوردید یا به کمک نیاز دارید، لطفاً بپرسید. اگر می‌خواهید سؤالات خوبی را در مکان‌های مناسب بپرسید، توصیه می‌کنیم بخش "بازخورد، سوالات و پشتیبانی" را مطالعه کنید.

Overview of technical areas
For an overview of Wikimedia technology and examples of the major areas where developers can contribute, visit Introduction to the Wikimedia Technical Ecosystem.

Contributing to software in MediaWiki
Are you a user of a MediaWiki wiki looking to add a feature or fix a bug in one? Please see to learn how to find and contribute to the software project part of MediaWiki you are looking for.



یک پروژه نرم افزاری را انتخاب کنید
The following projects offer resources, mentorship, and are looking for new developers to contribute to them. این روش توصیه شده برای شروع است. یکی از پروژه های زیر را انتخاب کنید و مستندات پروژه را دنبال کنید تا محیط توسعه خود را تنظیم کنید، یک کار را برای کار انتخاب کنید، کار را حل کنید و تغییرات کد خود را برای بررسی ارسال کنید: You are free to contribute to these projects or any others you are interested in related to Wikimedia. Most can be found by searching for them on or online.

''Are you a maintainer and want your project to be included in the list of software projects above? Find out more and join!''

Outreach programs and single tasks
In addition to the recommended software projects above, there are more ways to choose a project or task to work on:

Additional resources

 * Introduction to the Wikimedia Technical Ecosystem provides an overview of Wikimedia tech, focused on the major areas where developers can contribute.
 * How to contribute lists many more ways to contribute, including areas like documentation, testing, and more.
 * How to become a MediaWiki hacker: For developers who want to work on MediaWiki core or MediaWiki extensions.
 * Newbie guide for the Web team
 * Developer hub: More resources for established Wikimedia developers.
 * To ask your questions and to join general discussions, check the places listed on Communication.
 * Wikimedia tutorials: An index of tutorials that feature various languages, APIs, and frameworks in the Wikimedia technology stack.
 * Supporting newcomers at hackathons
 * Newcomer support at hackathons and the associated mentor guide
 * Newcomers section of the Hackathons Handbook, as well as the Mentoring Tips page
 * How-to page for newcomers at the Wikimedia Hackathon 2022