# How-To at a glance

<div dir="rtl" align="right" markdown="1">

*[این متن را در زبان‌های دیگر بخوانید](README.md#translations)*

</div>

<div dir="rtl" markdown="1">

**به `Free-Programming-Books` خوش آمدید!**

ما به مشارکت‌کنندگان جدید خوش‌آمد می‌گوییم. حتی آنهایی که اولین Pull Request (PR) خود را در GitHub ایجاد می کنند. اگر شما هم یکی از آنهایید، منابع زیر می‌توانند به شما کمک کنند.

* [درباره‌ی پول‌ریکوئست](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) *(in english)*
* [ایجاد یک درخواست کشش](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) *(in english)*
* [«سلام دنیا» در GitHub](https://docs.github.com/en/get-started/quickstart/hello-world) *(in english)*
* [YouTube - GitHub برای مبتدیان](https://www.youtube.com/watch?v=0fKg7e37bQE) *(in english)*
* [YouTube - چطور یک ریپوی GitHub را فورک کنیم و یک پول‌ریکوئست ثبت کنیم](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(in english)*
* [YouTube - دوره سقوط Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) *(in english)*


از سوال کردن خجالت نکشید. هر مشارکت‌کننده‌ای با اولین PR شروع کرده است. شما می‌توانید یکی از هزاران مشارکت‌کننده‌ی ما باشید!

<details align="center" markdown="1">
<summary>Click to see the growth users vs. time graphs.</summary>

[![EbookFoundation/free-programming-books's Contributor over time Graph](https://contributor-overtime-api.apiseven.com/contributors-svg?chart=contributorOverTime&repo=ebookfoundation/free-programming-books)](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books)

[![EbookFoundation/free-programming-books's Monthly Active Contributors graph](https://contributor-overtime-api.apiseven.com/contributors-svg?chart=contributorMonthlyActivity&repo=ebookfoundation/free-programming-books)](https://www.apiseven.com/en/contributor-graph?chart=contributorMonthlyActivity&repo=ebookfoundation/free-programming-books)

</details>

حتی اگر مشارکت‌کننده‌ی باتجربه‌ی پروژه‌های متن‌باز هستید، چیزهایی هست که شاید سطح شما را بالاتر ببرد. وقتی PR خود را ثبت می‌کنید، ***GitHub Actions* یک *linter* اجرا می‌کند که معمولا مشکلات فاصله‌گذاری یا ترتیب الفبایی را کشف می‌کند.** اگر دکمه‌ی سبز را دیدید، یعنی همه چیز برای بازبینی آماده است، در غیر این صورت، روی "Details" در پایین بازبینی شکست خورده کلیک کنید تا بفهمید لینتر چه چیزی را دوست نداشته است. مشکل را حل کنید و یک کامیت به PR خود اضافه کنید.

در پایان، اگر مطمئن نیستید که منبعی که می‌خواهید اضافه کنید، برای `Free-Programming-Books` مناسب باشد، راهنماهای [CONTRIBUTING](CONTRIBUTING-fa_IR.md) را بخوانید *([translations](README.md#translations) also available)*.

</div>