Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs(howto): Homogenize HowTo's format across translated files #6724

Merged
merged 31 commits into from
Feb 28, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
31 commits
Select commit Hold shift + click to select a range
0ee043d
Homogenize HowTo's
davorpa Feb 15, 2022
476717b
Rewording to be more meaningful
davorpa Feb 16, 2022
ab0a43e
Add H1 header + `Read this` ... aligned to right
davorpa Feb 16, 2022
976cb9d
remove trailing spaces
davorpa Feb 16, 2022
47993b0
Split a bit first paragraph to highlight welcome.
davorpa Feb 16, 2022
cd17881
homogenize `1-2` newlines amount between paragraphs
davorpa Feb 16, 2022
7ee485b
Update Github documentation links list
davorpa Feb 16, 2022
7efc667
GitHub trademark typos
davorpa Feb 16, 2022
645ab53
YouTube trademark typos
davorpa Feb 16, 2022
03fe0c8
`Welcome to fpb!` in bold style
davorpa Feb 16, 2022
7b599ac
Repo name backticked in monospace font
davorpa Feb 16, 2022
8ec36ba
reword es-en graph summary
davorpa Feb 16, 2022
3da88f2
Add a centered details block with graphs about contributions (users v…
davorpa Feb 17, 2022
2f035b8
GitHub trademark typos
davorpa Feb 17, 2022
a5c2749
Fix pull request typos and introduce it acronym
davorpa Feb 17, 2022
256a471
Update Github documentation links list
davorpa Feb 17, 2022
7b7809f
Some bolds to highlight common resources formating issues (like in CO…
davorpa Feb 17, 2022
327a2b2
Merge upstream/main into branch `docs/howto/sync/1`
davorpa Feb 17, 2022
b918d10
Merge #6701 upstream/main commit solving conflicts
davorpa Feb 17, 2022
925472a
Merge upstream/main into branch `docs/howto/sync/1`
davorpa Feb 17, 2022
aa2a6ff
Merge #6700 upstream/main commit solving conflicts
davorpa Feb 18, 2022
ae84445
Fix typos suggested by AhmedElTabarani
davorpa Feb 18, 2022
715a98d
Add paragrah from #5351. Need language translation
davorpa Feb 18, 2022
ae42294
New strings translated to `it` Italian
davorpa Feb 18, 2022
c205c43
use languages not countries. `in Egyptian Arabic`
davorpa Feb 18, 2022
963ef00
use languages not countries. `in Algerian Arabic`
davorpa Feb 18, 2022
5c329f6
remove notes from details block containing graphs about contributions…
davorpa Feb 18, 2022
4b886d9
Fix spanish typos
davorpa Feb 20, 2022
8bbf4be
Fix korean typos
davorpa Feb 20, 2022
660ade4
New strings translated to `ar` Arabic
davorpa Feb 27, 2022
193b7a9
New strings translated to `fr` French
davorpa Feb 27, 2022
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 29 additions & 12 deletions docs/HOWTO-ar.md
Original file line number Diff line number Diff line change
@@ -1,23 +1,40 @@
# How-To at a glance

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

*[إقرأ هذا بلغات أخرى](README.md#translations)*

</div>

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

مرحبا بكم في *!Free-Programming-Books* نرحّب بجميع المساهمين الجدد؛ ونرحب أيضا بهؤلاء الذين يريدون تقديم أول بولّ ريكويست لهم علي جيت هبّ. إن كنت واحدا منهم، فإليك بعض المصادر التي ربما تساعدك:
**مرحبا بكم في *!`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 - دورة تعليمية مكثفة عن لغة المارك داون](https://www.youtube.com/watch?v=HUBNt18RFbo) *(in English)*
* [YouTube - دورة تعليمية مكثفة عن لغة المارك داون](https://www.youtube.com/watch?v=1lZCkU5VpIs) *(in Algerian Arabic / بالجزائري)*
* [YouTube - دورات تعليمية عن GitHub للمبتدئين](https://www.youtube.com/playlist?list=PLDoPjvoNmBAw4eOj58MZPakHjaO3frVMF) *(in Egyptian Arabic / بالمصري)*


لا تخجل من أن تسأل، كل مساهم بدأ بأول PR له، ربما تكون من الآلاف المساهمين لدينا! لذا... لما لا تنضم إلى مجتمعنا [الكبير والمزدهر](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books).

<details align="center" markdown="1">
<summary>إضغط لترى الرسم البياني لنمو المساهمين بالنسبة للزمن.</summary>

* [عن البولّ ريكويست](https://help.github.com/articles/about-pull-requests/)
* [إنشاء بولّ ريكويست](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request)
* [جيت هبّ مرحبا يا عالَم](https://guides.github.com/activities/hello-world/)
* [يوتيوب - دورات تعليمية عن جيت هبّ للمبتدئين](https://www.youtube.com/watch?v=0fKg7e37bQE)
* [يوتيوب - كيف تنشئ نسختك من مستودع علي جيت هبّ وتقوم بتقديم بولّ ريكويست](https://www.youtube.com/watch?v=G1I3HF4YWEw)
* [يوتيوب - دورة تعليمية مكثفة عن لغة المارك داون](https://www.youtube.com/watch?v=HUBNt18RFbo)
* [يوتيوب - دورة تعليمية مكثفة عن لغة المارك داون](https://www.youtube.com/watch?v=1lZCkU5VpIs)
* [يوتيوب - دورات تعليمية عن جيت هبّ للمبتدئين](https://www.youtube.com/playlist?list=PLDoPjvoNmBAw4eOj58MZPakHjaO3frVMF)
[![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* بتشغيل فاحص تلقائيا لاكتشاف بعض الأخطاء الصغيرة التي قد تحدث بسبب المسافات أو الأخطاء الأبجدية.** فإذا كان الزر أخضرا، هذا يعني أن الكود جاهز للمراجعة، ولكن إن كان غير ذلك، إضغط علي "تفاصيل" تحت الإختبار الذي فشل لتري ما هي الأخطاء التي يجب أن تصححها قبل مراجعة الكود. بعد تصحيح الأخطاء قم بعمل كومّيت لإضافة التعديلات للـPR.

في النهاية، إذا لم تتأكد من أن المصادر التي تريد إضافتها مناسبة لـ *Free-Programming-Books*، فقم بقرآءة الدليل الإرشادي في [CONTRIBUTING](CONTRIBUTING.md). ([translations](README.md#translations))
في النهاية، إذا لم تتأكد من أن المصادر التي تريد إضافتها مناسبة لـ `Free-Programming-Books`، فقم بقرآءة الدليل الإرشادي في [CONTRIBUTING](CONTRIBUTING.md). ([translations](README.md#translations))

</div>
38 changes: 28 additions & 10 deletions docs/HOWTO-bn.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,34 @@
# How-To at a glance

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

*[অন্য ভাষায় এটা পড়ুন](README.md#translations)*

Free-Programming-Books রিপোজটরি তে স্বাগতম! আমরা নবাগত কন্ট্রিবিউটরস দের স্বাগতম জানাই; এমনকি যারা গিটহাবে এই প্রথম কোন "পুল রিকোয়েস্ট" তৈরি কয়েছেন। যদি আপনি তাদের একজন হয়ে থাকেন তাহলে নিচের রিসোর্স গুলো আপনার কাজে লাগতে পারেঃ
</div>

**`Free-Programming-Books` রিপোজটরি তে স্বাগতম!**

আমরা নবাগত কন্ট্রিবিউটরস দের স্বাগতম জানাই; এমনকি যারা GitHub এই প্রথম কোন Pull Request (PR) তৈরি কয়েছেন। যদি আপনি তাদের একজন হয়ে থাকেন তাহলে নিচের রিসোর্স গুলো আপনার কাজে লাগতে পারেঃ

* [পুল রিকোয়েস্ট কি?](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 - মার্কডাউন ক্র্যাশ কোর্স](https://www.youtube.com/watch?v=HUBNt18RFbo) *(in english)*


কোন প্রশ্ন করতে দ্বিধাবোধ করবেন না। সব কন্ট্রিবিউটরই ফার্স্ট PR থেকে শুরু করেছিল। So... why not join our [large, growing](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) community.কন্ট্রিবিউটর!

<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)

* [:us: পুল রিকোয়েস্ট কি?](https://help.github.com/articles/about-pull-requests/) *(in english)*
* [:us: কিভাবে পুল রিকোয়েস্ট দিব](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) *(in english)*
* [:us: গিটহাব হ্যালো ওয়ার্ল্ড](https://guides.github.com/activities/hello-world/) *(in english)*
* [:us: ইউটিউব - নতুনদের জন্য গিটহাব](https://www.youtube.com/watch?v=0fKg7e37bQE) *(in english)*
* [:us: ইউটিউব - কিভাবে একটি গিটহাব রিপোজিটরি ফোর্ক করবেন এবং পুল রিকোয়েস্ট সাবমিট করবেন](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(in english)*
* [:us: ইউটিউব - মার্কডাউন ক্র্যাশ কোর্স ](https://www.youtube.com/watch?v=HUBNt18RFbo) *(in english)*
[![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>

এমনকি আপনি যদি একজন অভিজ্ঞ ওপেন-সোর্স কন্ট্রিবিউটর ও হয়ে থাকেন, কখনও কখনো কিছু জিনিস ভুল হতেই পারে। যখন আপনি আপনার পুল রিকোয়েস্ট সাবমিট করবেন গিটহাব একশনস আপনার কোড কে যাচাই-বাছাই করবে, কখনো বা স্পেসিং বা ক্যাপিটালাইজেশন এর মত ছোটখাটো জিনিস খুঁজে বের করবে। যদি আপনি সবুজ বাটন পেয়ে যান, তাহলে বুঝতে পারবেন সবকিছু রিভিউ এর জন্য প্রস্তুত। কিন্তু যদি আপনি সবুজ বাটন না পান তাহলে ফেইল্ড হওয়া চেক এর নিচে "Details" এ ক্লিক করলে সমস্যাগুলি খুঁজে বের করতে পারবেন। তারপর সেই সমস্যাগুলো ফিক্স করার পর আপনার পুল রিকোয়েস্ট এ কমিট করবেন।
এমনকি আপনি যদি একজন অভিজ্ঞ ওপেন-সোর্স কন্ট্রিবিউটর ও হয়ে থাকেন, কখনও কখনো কিছু জিনিস ভুল হতেই পারে। যখন আপনি আপনার PR সাবমিট করবেন ***GitHub Actions* আপনার কোড কে যাচাই-বাছাই করবে, কখনো বা স্পেসিং বা ক্যাপিটালাইজেশন এর মত ছোটখাটো জিনিস খুঁজে বের করবে**। যদি আপনি সবুজ বাটন পেয়ে যান, তাহলে বুঝতে পারবেন সবকিছু রিভিউ এর জন্য প্রস্তুত। কিন্তু যদি আপনি সবুজ বাটন না পান তাহলে ফেইল্ড হওয়া চেক এর নিচে "Details" এ ক্লিক করলে সমস্যাগুলি খুঁজে বের করতে পারবেন। তারপর সেই সমস্যাগুলো ফিক্স করার পর আপনার PR এ কমিট করবেন।

যদি আপনার সন্দেহ হয় যে আপনার রিসোর্স "Free-Programming-Books" এর জন্য উপযুক্ত কিনা, এই গাইডলাইন্স পড়ে দেখুন- [CONTRIBUTING](CONTRIBUTING.md) ([translations](README.md#translations))
যদি আপনার সন্দেহ হয় যে আপনার রিসোর্স `Free-Programming-Books` এর জন্য উপযুক্ত কিনা, এই গাইডলাইন্স পড়ে দেখুন- [CONTRIBUTING](CONTRIBUTING.md) ([translations](README.md#translations))
37 changes: 27 additions & 10 deletions docs/HOWTO-bs.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,34 @@
# How-To at a glance

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

*[Pročitaj ovo u drugim jezicima](README.md#translations)*

Dobrodošli u Free-Programming-Books! Primamo nove kontributore; čak i one koji tek prave svoj prvi pull request na GitHub-u. Ako ste jedan od njih, ovdje je nekoliko izvora koji bi Vam mogli pomoći:
</div>

**Dobrodošli u `Free-Programming-Books`!**

Primamo nove kontributore; čak i one koji tek prave svoj prvi Pull Request (PR) na GitHub-u. Ako ste jedan od njih, ovdje je nekoliko izvora koji bi Vam mogli pomoći:

* [O pull request-ima](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) *(in english)*
* [Kreiranje pull request-a](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 Hello World](https://docs.github.com/en/get-started/quickstart/hello-world) *(in english)*
* [YouTube - GitHub tutorijal za početnike](https://www.youtube.com/watch?v=0fKg7e37bQE) *(in english)*
* [YouTube - Kako fork-ati GitHub repozitorij i postaviti pull request](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(in english)*
* [YouTube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo) *(in english)*


Namojte se ustručavati da postavljate pitanja; svaki kontributor je započeo sa prvim PR-om. So... why not join our [large, growing](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) community.

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

* [O pull request-ima](https://help.github.com/articles/about-pull-requests/)
* [Kreiranje pull request-a](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request)
* [GitHub Hello World](https://guides.github.com/activities/hello-world/)
* [YouTube - GitHub tutorijal za početnike](https://www.youtube.com/watch?v=0fKg7e37bQE)
* [YouTube - Kako fork-ati GitHub repozitorij i postaviti pull request](https://www.youtube.com/watch?v=G1I3HF4YWEw)
* [YouTube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo)
[![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)

Namojte se ustručavati da postavljate pitanja; svaki kontributor je započeo sa prvim PR-om. Vi biste mogli biti naš hiljaditi!
</details>

Čak i ako ste iskusan open source kontributor, postoje stvari u kojma biste se mogli zapetljati. Nakon što ste postavili Vaš PR, GitHub Actions će pokrenuti linter, koji često pronalazi problemčiće sa proredom ili abecednim redoslijedom. Ako dobijete zeleno dugme, sve je spremno za pregled, u suprotnom, kliknite "Details" ispod provjere koja nije uspjela kako biste otkrili šta se linter-u nije svidjelo. Ispravite problem i dodajte commit Vašem PR-u.
Čak i ako ste iskusan open source kontributor, postoje stvari u kojma biste se mogli zapetljati. Nakon što ste postavili Vaš PR, ***GitHub Actions* će pokrenuti *linter*, koji često pronalazi problemčiće sa proredom ili abecednim redoslijedom**. Ako dobijete zeleno dugme, sve je spremno za pregled, u suprotnom, kliknite "Details" ispod provjere koja nije uspjela kako biste otkrili šta se linter-u nije svidjelo. Ispravite problem i dodajte commit Vašem PR-u.

Na kraju, ako niste sigurni da je resurs koji želite dodati prikladan za Free-Programming-Books, pročitajte smjernice u [CONTRIBUTING](CONTRIBUTING.md). ([translations](README.md#translations))
Na kraju, ako niste sigurni da je resurs koji želite dodati prikladan za `Free-Programming-Books`, pročitajte smjernice u [CONTRIBUTING](CONTRIBUTING.md). ([translations](README.md#translations))
Loading