From 28ec79103b7ff7c7df417b9647e895f83f2a2314 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?David=20Ord=C3=A1s?= <3125580+davorpa@users.noreply.github.com> Date: Mon, 28 Feb 2022 17:04:55 +0100 Subject: [PATCH] docs(howto): Homogenize HowTo's format across translated files (#6724) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Homogenize HowTo's - Add H1 header - `Read this` ... right alignmements - Split a bit first paragraph to highlight welcome. - Introduce Pull Request acronym. - trademarks / typos: GitHub, YouTube, Pull Request - Update GitHub links urls. `help`/`guides` subdomain was moved to `docs` so now a 301 Redirect is skipped. - Details block added, with center align. When clicked, the contributor graphs is toggled. - Some bolds to highlight common resources formating issues (like in CONTRIBUTING) - Repo name in monospace font - Re-worded last part of 4th paragraph to explain that no new PR is needed to open if there are linter errors or changes are requested. Now it's more clear, I thought. Via EbookFoundation/free-programming-books#6590 * Rewording to be more meaningful * Add H1 header + `Read this` ... aligned to right Via EbookFoundation/free-programming-books#6590 * remove trailing spaces * Split a bit first paragraph to highlight welcome. Via EbookFoundation/free-programming-books#6590 * homogenize `1-2` newlines amount between paragraphs * Update Github documentation links list - Update GitHub links urls. `help`/`guides` subdomain was moved to `docs` so now a 301 Redirect is skipped. - Remove flag emojis from link, perhaps use text in notes format to give accesibility locale context Via EbookFoundation/free-programming-books#6590 * GitHub trademark typos * YouTube trademark typos * `Welcome to fpb!` in bold style * Repo name backticked in monospace font (non-translatable) * reword es-en graph summary * Add a centered details block with graphs about contributions (users vs. time) Detail blocks are toggleable sections in GitHub Provided graphs by apiseven: - Contributor over time Graph - Monthly Active Contributors graph * GitHub trademark typos * Fix pull request typos and introduce it acronym * Update Github documentation links list - Update GitHub links urls. `help`/`guides` subdomain was moved to `docs` so now a 301 Redirect is skipped. - Remove flag emojis from link, perhaps use text in notes format to give accesibility locale context The forgot rest addressed on 7ee485bb3b1f16cd58aa4aacef3f8af19fb588ea commit Via EbookFoundation/free-programming-books#6590 * Some bolds to highlight common resources formating issues (like in CONTRIBUTING) * Fix typos suggested by AhmedElTabarani Co-authored-by: أحمد الطبراني * Add paragrah from #5351. Need language translation * New strings translated to `it` Italian Co-authored-by: ImVector <59611597+LuigiImVector@users.noreply.github.com> * use languages not countries. `in Egyptian Arabic` * use languages not countries. `in Algerian Arabic` * remove notes from details block containing graphs about contributions (users vs. time) * Fix spanish typos Co-authored-by: Wonjang Son * Fix korean typos Co-authored-by: Wonjang Son * New strings translated to `ar` Arabic Co-authored-by: أحمد الطبراني * New strings translated to `fr` French Co-authored-by: Loic Beylot Co-authored-by: أحمد الطبراني Co-authored-by: ImVector <59611597+LuigiImVector@users.noreply.github.com> Co-authored-by: Wonjang Son Co-authored-by: Loic Beylot --- docs/HOWTO-ar.md | 41 +++++++++++++++++++++++++++------------ docs/HOWTO-bn.md | 38 ++++++++++++++++++++++++++---------- docs/HOWTO-bs.md | 37 +++++++++++++++++++++++++---------- docs/HOWTO-de.md | 31 +++++++++++++++++++++++------- docs/HOWTO-el.md | 37 +++++++++++++++++++++++++---------- docs/HOWTO-es.md | 37 +++++++++++++++++++++++++---------- docs/HOWTO-fa_IR.md | 38 ++++++++++++++++++++++++++---------- docs/HOWTO-fil.md | 37 +++++++++++++++++++++++++---------- docs/HOWTO-fr.md | 33 ++++++++++++++++++++++++------- docs/HOWTO-hi.md | 36 ++++++++++++++++++++++++++-------- docs/HOWTO-id.md | 38 ++++++++++++++++++++++++++---------- docs/HOWTO-it.md | 37 +++++++++++++++++++++++++---------- docs/HOWTO-km.md | 37 +++++++++++++++++++++++++---------- docs/HOWTO-ko.md | 37 +++++++++++++++++++++++++---------- docs/HOWTO-nl.md | 37 +++++++++++++++++++++++++---------- docs/HOWTO-pl.md | 37 +++++++++++++++++++++++++---------- docs/HOWTO-pt_BR.md | 32 ++++++++++++++++++++++-------- docs/HOWTO-ru.md | 47 ++++++++++++++++++++++++++++++--------------- docs/HOWTO-sl.md | 37 +++++++++++++++++++++++++---------- docs/HOWTO-sv.md | 40 ++++++++++++++++++++++++++++---------- docs/HOWTO-th.md | 38 ++++++++++++++++++++++++++---------- docs/HOWTO-tr.md | 37 +++++++++++++++++++++++++---------- docs/HOWTO-uk.md | 38 ++++++++++++++++++++++++++---------- docs/HOWTO-vi.md | 38 ++++++++++++++++++++++++++---------- docs/HOWTO-zh.md | 39 ++++++++++++++++++++++++++----------- docs/HOWTO-zh_TW.md | 37 +++++++++++++++++++++++++---------- docs/HOWTO.md | 37 +++++++++++++++++++++++++---------- 27 files changed, 740 insertions(+), 268 deletions(-) diff --git a/docs/HOWTO-ar.md b/docs/HOWTO-ar.md index dca1c6004..c498255a9 100644 --- a/docs/HOWTO-ar.md +++ b/docs/HOWTO-ar.md @@ -1,23 +1,40 @@ +# How-To at a glance + +
+ *[إقرأ هذا بلغات أخرى](README.md#translations)* +
+
-مرحبا بكم في *!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). + +
+إضغط لترى الرسم البياني لنمو المساهمين بالنسبة للزمن. -* [عن البولّ ريكويست](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) -لا تخجل من أن تسأل، كل مساهم بدأ بأول بولّ ريكويست له، ربما تكون من الآلاف المساهمين لدينا! +
-حتي لو كنت مساهما متمرسا في المشاريع مفتوحة المصدر، هناك بعض الأشياء التي ربما تقف في طريقك. فعند تقديمك للبولّ ريكويست، يقوم *جيت هبّ أكشن* بتشغيل فاحص تلقائيا لاكتشاف بعض الأخطاء الصغيرة التي قد تحدث بسبب المسافات أو الأخطاء الأبجدية. فإذا كان الزر أخضرا، هذا يعني أن الكود جاهز للمراجعة، ولكن إن كان غير ذلك، إضغط علي "تفاصيل" تحت الإختبار الذي فشل لتري ما هي الأخطاء التي يجب أن تصححها قبل مراجعة الكود. بعد تصحيح الأخطاء قم بعمل كومّيت لإضافة التعديلات للبولّ ريكويست. +حتي لو كنت مساهما متمرسا في المشاريع مفتوحة المصدر، هناك بعض الأشياء التي ربما تقف في طريقك. فعند تقديمك للـPR، يقوم ***GitHub Actions* بتشغيل فاحص تلقائيا لاكتشاف بعض الأخطاء الصغيرة التي قد تحدث بسبب المسافات أو الأخطاء الأبجدية.** فإذا كان الزر أخضرا، هذا يعني أن الكود جاهز للمراجعة، ولكن إن كان غير ذلك، إضغط علي "تفاصيل" تحت الإختبار الذي فشل لتري ما هي الأخطاء التي يجب أن تصححها قبل مراجعة الكود. بعد تصحيح الأخطاء قم بعمل كومّيت لإضافة التعديلات للـPR. -في النهاية، إذا لم تتأكد من أن المصادر التي تريد إضافتها مناسبة لـ *Free-Programming-Books*، فقم بقرآءة الدليل الإرشادي في [CONTRIBUTING](CONTRIBUTING.md). ([translations](README.md#translations)) +في النهاية، إذا لم تتأكد من أن المصادر التي تريد إضافتها مناسبة لـ `Free-Programming-Books`، فقم بقرآءة الدليل الإرشادي في [CONTRIBUTING](CONTRIBUTING.md). ([translations](README.md#translations))
diff --git a/docs/HOWTO-bn.md b/docs/HOWTO-bn.md index 3d5b50873..0cd8de6d9 100644 --- a/docs/HOWTO-bn.md +++ b/docs/HOWTO-bn.md @@ -1,16 +1,34 @@ +# How-To at a glance + +
+ *[অন্য ভাষায় এটা পড়ুন](README.md#translations)* -Free-Programming-Books রিপোজটরি তে স্বাগতম! আমরা নবাগত কন্ট্রিবিউটরস দের স্বাগতম জানাই; এমনকি যারা গিটহাবে এই প্রথম কোন "পুল রিকোয়েস্ট" তৈরি কয়েছেন। যদি আপনি তাদের একজন হয়ে থাকেন তাহলে নিচের রিসোর্স গুলো আপনার কাজে লাগতে পারেঃ +
+ +**`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.কন্ট্রিবিউটর! + +
+Click to see the growth users vs. time graphs. + +[![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" এ ক্লিক করলে সমস্যাগুলি খুঁজে বের করতে পারবেন। তারপর সেই সমস্যাগুলো ফিক্স করার পর আপনার পুল রিকোয়েস্ট এ কমিট করবেন। +এমনকি আপনি যদি একজন অভিজ্ঞ ওপেন-সোর্স কন্ট্রিবিউটর ও হয়ে থাকেন, কখনও কখনো কিছু জিনিস ভুল হতেই পারে। যখন আপনি আপনার 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)) diff --git a/docs/HOWTO-bs.md b/docs/HOWTO-bs.md index 48075090d..ec91ceca2 100644 --- a/docs/HOWTO-bs.md +++ b/docs/HOWTO-bs.md @@ -1,17 +1,34 @@ +# How-To at a glance + +
+ *[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: +
+ +**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. + +
+Click to see the growth users vs. time graphs. -* [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! +
-Č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)) diff --git a/docs/HOWTO-de.md b/docs/HOWTO-de.md index d6fd3ea64..2aeb8d6ab 100644 --- a/docs/HOWTO-de.md +++ b/docs/HOWTO-de.md @@ -1,16 +1,33 @@ +# How-To at a glance + +
+ *[Lese das hier auch in anderen Sprachen](README.md#translations)* -Willkommen zu *Free-Programming-Books*! Wir heißen neue Beitragende herzlich willkommen. Auch die, die ihren ersten Pull Request (PR) auf GitHub machen möchten. Wenn Du eine dieser Personen bist, dann findest Du hier einige nützliche Ressourcen: +
+ +**Willkommen zu `Free-Programming-Books`!** + +Wir heißen neue Beitragende herzlich willkommen. Auch die, die ihren ersten Pull Request (PR) auf GitHub machen möchten. Wenn Du eine dieser Personen bist, dann findest Du hier einige nützliche Ressourcen: -* [Informationen zu Pull Requests](https://docs.github.com/de/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) -* [Pull Requests erstellen](https://docs.github.com/de/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) -* [GitHub Hallo Welt](https://guides.github.com/activities/hello-world/) *(auf Englisch)* +* [Informationen zu Pull Requests](https://docs.github.com/de/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/about-pull-requests) +* [Pull Requests erstellen](https://docs.github.com/de/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) +* [GitHub Hallo Welt](https://docs.github.com/en/get-started/quickstart/hello-world) *(auf Englisch)* * [YouTube - Tutorial GitHub für Anfänger](https://www.youtube.com/watch?v=0fKg7e37bQE) *(auf Englisch)* * [YouTube - So forkst Du ein GitHub-Repo und sendest einen Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(auf Englisch)* * [YouTube - GitHub Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) *(auf Englisch)* -Habe keine Angst eine Frage zu stellen. Jeder fängt mal an und macht irgendwann seinen allerersten Pull Request. Du könntest unser tausendster sein. +Habe keine Angst eine Frage zu stellen. Jeder fängt mal an und macht irgendwann seinen allerersten PR. So... why not join our [large, growing](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) community. + +
+Click to see the growth users vs. time graphs. + +[![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) + +
-Selbst, wenn Du ein erfahrener Open-Source-Mitwirkender bist, könnte es Dinge geben, die Dich ins Straucheln bringen. Sobald Du Deinen PR eingereicht hast, führt GitHub Actions einen Linter aus und findet oft kleine Probleme mit Absätzen oder Alphabetisierung. Wenn Du eine grüne Schaltfläche siehst, ist alles zur Überprüfung bereit. Aber wenn das nicht der Fall ist, klicke unter der fehlgeschlagenen Überprüfung auf "Details", um herauszufinden, was dem Linter nicht gefallen hat. Behebe das Problem und füge Deinem PR einen Commit hinzu. +Selbst, wenn Du ein erfahrener Open-Source-Mitwirkender bist, könnte es Dinge geben, die Dich ins Straucheln bringen. Sobald Du Deinen PR eingereicht hast, führt ***GitHub Actions* einen *Linter* aus und findet oft kleine Probleme mit Absätzen oder Alphabetisierung**. Wenn Du eine grüne Schaltfläche siehst, ist alles zur Überprüfung bereit. Aber wenn das nicht der Fall ist, klicke unter der fehlgeschlagenen Überprüfung auf "Details", um herauszufinden, was dem Linter nicht gefallen hat. Behebe das Problem und füge Deinem PR einen Commit hinzu. -Wenn Du Dir nicht sicher bist, ob die Ressource, die Du hinzufügen möchtest, für Free-Programming-Books geeignet ist, lies Dir die Richtlinien in [Mitwirken](CONTRIBUTING-de.md) durch. ([translations](README.md#translations)) +Wenn Du Dir nicht sicher bist, ob die Ressource, die Du hinzufügen möchtest, für `Free-Programming-Books` geeignet ist, lies Dir die Richtlinien in [Mitwirken](CONTRIBUTING-de.md) durch. ([translations](README.md#translations)) diff --git a/docs/HOWTO-el.md b/docs/HOWTO-el.md index fc9df5d94..8a9cc6cfa 100644 --- a/docs/HOWTO-el.md +++ b/docs/HOWTO-el.md @@ -1,17 +1,34 @@ +# How-To at a glance + +
+ *[Διαβάστε το σε διαφορετικές γλώσσες](README.md#translations)* -Καλώς ήλθατε στο Free-Programming-Books! Καλωσορίζουμε τους νέους συνεισφέροντες· ακόμα και αυτούς που κάνουν το πρώτο τους pull request (PR) στο Github. Αν είστε ένας από αυτούς, ορίστε λίγο υλικό που μπορεί να βοηθήσει: +
+ +**Καλώς ήλθατε στο `Free-Programming-Books`!** + +Καλωσορίζουμε τους νέους συνεισφέροντες· ακόμα και αυτούς που κάνουν το πρώτο τους Pull Request (PR) στο GitHub. Αν είστε ένας από αυτούς, ορίστε λίγο υλικό που μπορεί να βοηθήσει: + +* [Σχετικά με τα Pull Requests](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) *(στα αγγλικά)* +* [Δημιουργώντας pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) *(στα αγγλικά)* +* [Hello World στο GitHub](https://docs.github.com/en/get-started/quickstart/hello-world) *(στα αγγλικά)* +* [YouTube - Tutorial στο GitHub Για Αρχάριους](https://www.youtube.com/watch?v=0fKg7e37bQE) *(στα αγγλικά)* +* [YouTube - Πως να Κάνετε Fork ένα αποθετήριο στο GitHub και να Υποβάλετε Ένα Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(στα αγγλικά)* +* [YouTube - Σύντομο Μάθημα Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) *(στα αγγλικά)* + + +Μη διστάσετε να κάνετε ερωτήσεις· κάθε συνεισφέρων ξεκίνησε ένα πρώτο PR. So... why not join our [large, growing](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) community. + +
+Click to see the growth users vs. time graphs. -* [Σχετικά με τα Pull Requests](https://help.github.com/articles/about-pull-requests/) *(στα αγγλικά)* -* [Δημιουργώντας pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) *(στα αγγλικά)* -* [Hello World στο Github](https://guides.github.com/activities/hello-world/) *(στα αγγλικά)* -* [Youtube - Tutorial στο Github Για Αρχάριους](https://www.youtube.com/watch?v=0fKg7e37bQE) *(στα αγγλικά)* -* [Youtube - Πως να Κάνετε Fork ένα αποθετήριο στο GitHub και να Υποβάλετε Ένα Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(στα αγγλικά)* -* [Youtube - Σύντομο Μάθημα Markdown](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) -Μη διστάσετε να κάνετε ερωτήσεις· κάθε συνεισφέρων ξεκίνησε ένα πρώτο PR. Μπορεί να είστε το χιλιοστό μας! +
-Ακόμα και αν είστε έμπειρος συνεισφέρων, υπάρχουν πράγματα που μπορεί να σας μπερδέψουν. Όταν έχετε υποβάλλει το PR σας, το GitHub Actions θα τρέχει ένα linter, που βρίσκει συνήθως μικρά θέματα με τα κενά ή την αλφαβητική σειρά. Αν δείτε ένα πράσινο κουμπί, όλα είναι έτοιμα για ανασκόπηση, αλλά αν όχι, πατήστε "Details" (λεπτομέρειες) κάτω από τον έλεγχο που απέτυχε για να μάθετε τι δεν άρεσε στον linter. Διορθώστε το πρόβλημα και προσθέστε ένα commit στο PR σας. +Ακόμα και αν είστε έμπειρος συνεισφέρων, υπάρχουν πράγματα που μπορεί να σας μπερδέψουν. Όταν έχετε υποβάλλει το PR σας, το ***GitHub Actions* θα τρέχει ένα *linter*, που βρίσκει συνήθως μικρά θέματα με τα κενά ή την αλφαβητική σειρά**. Αν δείτε ένα πράσινο κουμπί, όλα είναι έτοιμα για ανασκόπηση, αλλά αν όχι, πατήστε "Details" (λεπτομέρειες) κάτω από τον έλεγχο που απέτυχε για να μάθετε τι δεν άρεσε στον linter. Διορθώστε το πρόβλημα και προσθέστε ένα commit στο PR σας. -Τέλος, αν δεν είστε σίγουροι αν το υλικό που θέλετε να προσθέσετε είναι κατάλληλο για το Free-Programming-Books, διαβάστε προσεκτικά τις κατευθυντήριες γραμμές στο [CONTRIBUTING](CONTRIBUTING-el.md). ([translations](README.md#translations)) +Τέλος, αν δεν είστε σίγουροι αν το υλικό που θέλετε να προσθέσετε είναι κατάλληλο για το `Free-Programming-Books`, διαβάστε προσεκτικά τις κατευθυντήριες γραμμές στο [CONTRIBUTING](CONTRIBUTING-el.md). ([translations](README.md#translations)) diff --git a/docs/HOWTO-es.md b/docs/HOWTO-es.md index 3dc4e8ff2..d7309a664 100644 --- a/docs/HOWTO-es.md +++ b/docs/HOWTO-es.md @@ -1,17 +1,34 @@ +# Primeros pasos + +
+ *[Lea esto en otros idiomas](README.md#translations)* -¡Sea bienvenido a *Free-Programming-Books*! Damos una calurosa bienvenida a los nuevos colaboradores; incluso a aquellos que realizan su primera Pull Request (PR) en GitHub. Si es usted uno de ellos, aquí van algunos recursos que quizás le pueden ayudar: +
+ +**¡Sea bienvenido(a) a `Free-Programming-Books`!** + +Siempre damos una calurosa bienvenida a los nuevos colaboradores; incluso a aquellos que realizan su primera Pull Request (PR) en GitHub. Si es usted uno de ellos, aquí van algunos recursos que quizás le pueden ayudar: + +* [Acerca de las pull requests](https://docs.github.com/es/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) +* [Creando una pull request](https://docs.github.com/es/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) +* [GitHub Hola Mundo](https://docs.github.com/es/get-started/quickstart/hello-world) +* [YouTube - Tutorial GitHub para principiantes](https://www.youtube.com/watch?v=0fKg7e37bQE) *(en inglés)* +* [YouTube - Como bifurcar un repositorio GitHub y Enviar una Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(en inglés)* +* [YouTube - Curso intensivo de Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) *(en inglés)* + + +No se quede nunca con dudas, ni tenga miedo de hacer preguntas; todo buen colaborador que usted puede ver en el repositorio, comenzó en su día con una primera PR. Así que... ¿qué tal si se une a [nuestra extensa y creciente](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) communidad? + +
+Click para detalle gráfico sobre dicho crecimiento (usuarios vs. tiempo) -* [Acerca de las Pull Requests](https://docs.github.com/es/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) -* [Creando una Pull Request](https://docs.github.com/es/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) -* [GitHub Hola Mundo](https://guides.github.com/activities/hello-world/) *(en inglés)* -* [Youtube - Tutorial GitHub para principiantes](https://www.youtube.com/watch?v=0fKg7e37bQE) *(en inglés)* -* [Youtube - Como bifurcar un repositorio GitHub y Enviar una Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(en inglés)* -* [Youtube - Curso intensivo de Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) *(en inglés)* +[![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) -No se quede nunca con la duda, ni tenga miedo de hacer preguntas; todo colaborador que usted ve en el repositorio, comenzó en su día con una primera PR. ¡Qué tal si es nuestro mil-milésimo primer! +
-Incluso si ya tiene algo de experiencia como colaborador en otros proyectos de código abierto, hay algunas cosas que pueden hacerle dar un traspiés. Una vez enviada su PR, *GitHub Actions* ejecutará un *linter*; el cuál se encarga a menudo de encontrar pequeños problemas con el espaciado, enlazado, sintaxis o la alfabetización. Si al finalizar este proceso de integración continua se enciende la luz verde, es que todo está listo para su revisión; pero si no, haga clic en los "enlaces de Detalle" que proporciona para averiguar qué fue exactamente lo que falló. Solucione dicho problema y agregue los cambios a su PR mediante un nuevo commit. +Incluso si ya tiene algo de experiencia como colaborador en otros proyectos de código abierto, hay algunas cosas que pueden hacerle dar un traspiés. Una vez enviada su PR, ***GitHub Actions* ejecutará un *linter*; el cuál se encarga a menudo de encontrar pequeños problemas con el espaciado, enlaces, sintaxis o la alfabetización**. Si al finalizar este proceso de integración continua se enciende la luz verde, es que todo está listo para su revisión; pero si no, haga clic en el enlace de "Detalles" proporcionado para averiguar qué fue exactamente lo que falló. Solucione dicho problema y agregue los cambios a su PR mediante un nuevo commit sobre la rama con la que inició la petición de cambios. -Por último, si no está del todo seguro de si el recurso que desea agregar es apropiado para *Free-Programming-Books*, lea detenidamente las pautas que puede encontrar en [CONTRIBUTING](CONTRIBUTING-es.md) ([traducciones / otros idiomas](README.md#translations)). +Por último, si no está del todo seguro de si el recurso que desea agregar es apropiado para `Free-Programming-Books`, lea detenidamente las pautas que puede encontrar en [CONTRIBUTING](CONTRIBUTING-es.md) (también [traducido a otros idiomas](README.md#translations)). diff --git a/docs/HOWTO-fa_IR.md b/docs/HOWTO-fa_IR.md index a7a80f495..4a382fc2a 100644 --- a/docs/HOWTO-fa_IR.md +++ b/docs/HOWTO-fa_IR.md @@ -1,20 +1,38 @@ +# How-To at a glance + +
+ *[این متن را در زبان‌های دیگر بخوانید](README.md#translations)* +
-به Free-Programming-Books خوش آمدید! ما به مشارکت‌کنندگان جدید خوش‌آمد می‌گوییم. حتی آنهایی که اولین پول‌ریکوئست خود را در گیت‌هاب ایجاد می کنند. اگر شما هم یکی از آنهایید، منابع زیر می‌توانند به شما کمک کنند. -* [درباره‌ی پول‌ریکوئست](https://help.github.com/articles/about-pull-requests/) -* [«سلام دنیا» در گیت‌هاب](https://guides.github.com/activities/hello-world/) -* [یوتیوب - گیت‌هاب برای مبتدیان](https://www.youtube.com/watch?v=0fKg7e37bQE) -* [یوتیوب - چطور یک ریپوی گیت‌هاب را فورک کنیم و یک پول‌ریکوئست ثبت کنیم.](https://www.youtube.com/watch?v=G1I3HF4YWEw) +**به `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)* -حتی اگر مشارکت‌کننده‌ی باتجربه‌ی پروژه‌های متن‌باز هستید، چیزهایی هست که شاید سطح شما را بالاتر ببرد. وقتی پی‌آر خود را ثبت می‌کنید، GitHub Actions یک linter اجرا می‌کند که معمولا مشکلات فاصله‌گذاری یا ترتیب الفبایی را کشف می‌کند. اگر دکمه‌ی سبز را دیدید، یعنی همه چیز برای بازبینی آماده است، در غیر این صورت، روی "Details" در پایین بازبینی شکست خورده کلیک کنید تا بفهمید لینتر چه چیزی را دوست نداشته است. مشکل را حل کنید و یک کامیت به پی‌آر خود اضافه کنید. -در پایان، اگر مطمئن نیستید که منبعی که می‌خواهید اضافه کنید، برای Free-Programming-Books مناسب باشد، راهنماهای [CONTRIBUTING](CONTRIBUTING-fa_IR.md) را بخوانید. -
+از سوال کردن خجالت نکشید. هر مشارکت‌کننده‌ای با اولین PR شروع کرده است. شما می‌توانید یکی از هزاران مشارکت‌کننده‌ی ما باشید! + +
+Click to see the growth users vs. time graphs. + +[![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) -([translations](README.md#translations)) +[![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) + +
+ +حتی اگر مشارکت‌کننده‌ی باتجربه‌ی پروژه‌های متن‌باز هستید، چیزهایی هست که شاید سطح شما را بالاتر ببرد. وقتی PR خود را ثبت می‌کنید، ***GitHub Actions* یک *linter* اجرا می‌کند که معمولا مشکلات فاصله‌گذاری یا ترتیب الفبایی را کشف می‌کند.** اگر دکمه‌ی سبز را دیدید، یعنی همه چیز برای بازبینی آماده است، در غیر این صورت، روی "Details" در پایین بازبینی شکست خورده کلیک کنید تا بفهمید لینتر چه چیزی را دوست نداشته است. مشکل را حل کنید و یک کامیت به PR خود اضافه کنید. + +در پایان، اگر مطمئن نیستید که منبعی که می‌خواهید اضافه کنید، برای `Free-Programming-Books` مناسب باشد، راهنماهای [CONTRIBUTING](CONTRIBUTING-fa_IR.md) را بخوانید *([translations](README.md#translations) also available)*. + + diff --git a/docs/HOWTO-fil.md b/docs/HOWTO-fil.md index 8000ffa21..472d91e7c 100644 --- a/docs/HOWTO-fil.md +++ b/docs/HOWTO-fil.md @@ -1,17 +1,34 @@ -*[Basahin ito sa ibang mga wika](README.md#nslations)* +# How-To at a glance -Maligayang pagdating sa Free-Programming-Books! Tinatanggap namin ang mga bagong kontribyutor; kahit na ang mga gumagawa ng kanilang pinakaunang pull request sa Github. Kung isa ka sa mga iyon, narito ang ilang mapagkukunan na maaaring makatulong: +
-* [About Pull Requests](https://help.github.com/articles/about-pull-requests/) -* [Creating a pull request](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 Tutorial For Beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) -* [Youtube - How To Fork A GitHub Repo and Submit A Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) -* [Youtube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo) +*[Basahin ito sa ibang mga wika](README.md#translations)* + +
+ +**Maligayang pagdating sa `Free-Programming-Books`!** + +Tinatanggap namin ang mga bagong kontribyutor; kahit na ang mga gumagawa ng kanilang pinakaunang Pull Request (PR) sa GitHub. Kung isa ka sa mga iyon, narito ang ilang mapagkukunan na maaaring makatulong: + +* [About Pull Requests](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) *(in english)* +* [Creating a pull request](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 Tutorial For Beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) *(in english)* +* [YouTube - How To Fork A GitHub Repo and Submit A Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(in english)* +* [YouTube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo) *(in english)* Huwag mag-atubiling magtanong; bawat kontribyutor ay nagsimula sa isang unang PR. Maaaring ikaw ang aming ika-libo! -Kahit na isa kang makaranasang open source na nag-ambag, may mga bagay na maaaring magalit sa iyo. Sa sandaling naisumite mo na ang iyong PR, ang GitHub Actions ay magpapatakbo ng isang linter, kadalasang nakakahanap ng maliliit na isyu sa spacing o alphabetization. Kung nakakuha ka ng berdeng button, handa na ang lahat para sa pagsusuri, ngunit kung hindi, i-click ang "Mga Detalye" sa ilalim ng tseke na nabigong malaman kung ano ang hindi nagustuhan ng linter. Ayusin ang problema at magdagdag ng commit sa iyong PR. +
+Click to see the growth users vs. time graphs. + +[![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) + +
+ +Kahit na isa kang makaranasang open source na nag-ambag, may mga bagay na maaaring magalit sa iyo. Sa sandaling naisumite mo na ang iyong PR, ang ***GitHub Actions* ay magpapatakbo ng isang *linter*, kadalasang nakakahanap ng maliliit na isyu sa spacing o alphabetization**. Kung nakakuha ka ng berdeng button, handa na ang lahat para sa pagsusuri, ngunit kung hindi, i-click ang "Mga Detalye" sa ilalim ng tseke na nabigong malaman kung ano ang hindi nagustuhan ng linter. Ayusin ang problema at magdagdag ng commit sa iyong PR. -Panghuli, kung hindi ka sigurado na ang resource na gusto mong idagdag ay angkop para sa Free-Programming-Books, basahin ang mga alituntunin sa [CONTRIBUTING](CONTRIBUTING-fil.md). ([translations](README.md#nslations)) +Panghuli, kung hindi ka sigurado na ang resource na gusto mong idagdag ay angkop para sa `Free-Programming-Books`, basahin ang mga alituntunin sa [CONTRIBUTING](CONTRIBUTING-fil.md). ([translations](README.md#translations)) diff --git a/docs/HOWTO-fr.md b/docs/HOWTO-fr.md index 7fbe5674d..76f89fa87 100644 --- a/docs/HOWTO-fr.md +++ b/docs/HOWTO-fr.md @@ -1,15 +1,34 @@ +# Mode d'emploi en bref + +
+ *[Lisez ceci dans d'autres langues](README.md#translations)* -Bienvenue à Free-Programming-Books! Nous souhaitons la bienvenue aux nouveaux contributeurs; même ceux qui font leur toute première pull request sur Github. Si vous faites partie de ceux-ci, voici quelques ressources qui pourraient vous aider: +
+ +**Bienvenue à `Free-Programming-Books`!** + +Nous souhaitons la bienvenue aux nouveaux contributeurs; même ceux qui font leur toute première Pull Request (PR) sur GitHub. Si vous faites partie de ceux-ci, voici quelques ressources qui pourraient vous aider: -* [A propos des Pull Requests](https://help.github.com/articles/about-pull-requests/) -* [Github Bonjour le monde](https://guides.github.com/activities/hello-world/) -* [Youtube - Comment Fork un Repo GitHub et Soumettre une Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) -* [Youtube - Tutoriel Github pour debutant](https://www.youtube.com/watch?v=0fKg7e37bQE) +* [A propos des pull requests](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) *(en anglais)* +* [Création d'une pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) *(en anglais)* +* [GitHub Bonjour le monde](https://docs.github.com/en/get-started/quickstart/hello-world) *(en anglais)* +* [YouTube - Comment Fork un Repo GitHub et Soumettre une Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(en anglais)* +* [YouTube - Tutoriel GitHub pour debutant](https://www.youtube.com/watch?v=0fKg7e37bQE) *(en anglais)* +* [YouTube - Cours intensif d'Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) *(en anglais)* N'hésitez pas à poser des questions; chaque contributeur a commencé par une première PR. Vous pourriez être notre millième! -Même si vous êtes un contributeur open source expérimenté, il y a des choses qui peuvent vous faire trébucher. Une fois que vous avez soumis votre PR, GitHub Actions exécutera un linter, trouvant souvent de petits problèmes d'espacement ou d'alphabétisation. Si vous obtenez un bouton vert, tout est prêt pour l'examen, mais sinon, cliquez sur "Détails" sous la vérification qui n'a pas réussi pour découvrir ce que le linter n'a pas aimé. Résolvez le problème et ajoutez un commit à votre PR. +
+Cliquez pour voir les graphiques de croissance des utilisateurs en fonction du temps. + +[![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) + +
+ +Même si vous êtes un contributeur open source expérimenté, il y a des choses qui peuvent vous faire trébucher. Une fois que vous avez soumis votre PR, ***GitHub Actions* exécutera un *linter*, trouvant souvent de petits problèmes d'espacement ou d'alphabétisation**. Si vous obtenez un bouton vert, tout est prêt pour l'examen, mais sinon, cliquez sur "Détails" sous la vérification qui n'a pas réussi pour découvrir ce que le linter n'a pas aimé. Résolvez le problème et ajoutez un commit à votre PR. -Enfin, si vous n'êtes pas sûr que la ressource que vous souhaitez ajouter soit appropriée pour Free-Programming-Books, lisez les instructions dans [CONTRIBUTING](CONTRIBUTING-fr.md). ([translations](README.md#translations)) +Enfin, si vous n'êtes pas sûr que la ressource que vous souhaitez ajouter soit appropriée pour `Free-Programming-Books`, lisez les instructions dans [CONTRIBUTING](CONTRIBUTING-fr.md). ([traductions](README.md#translations)) diff --git a/docs/HOWTO-hi.md b/docs/HOWTO-hi.md index 5fc6c5912..f0f4d4afa 100644 --- a/docs/HOWTO-hi.md +++ b/docs/HOWTO-hi.md @@ -1,14 +1,34 @@ +# How-To at a glance + +
+ *[इस लेख को अन्य भाषाओं में पढ़ें](README.md#translations)* -फ्री-प्रोग्रामिंग-पुस्तकों में आपका स्वागत है! हम नए योगदानकर्ताओं का स्वागत करते हैं; यहां तक ​​कि उन लोगों के लिए जो Github पर अपना पहला पुल अनुरोध करते हैं। यदि आप उनमें से एक हैं, तो यहां कुछ संसाधन हैं जो मदद कर सकते हैं: -* [About Pull Requests](https://help.github.com/articles/about-pull-requests/) -* [Github Hello World](https://guides.github.com/activities/hello-world/) -* [Youtube - Github Tutorial For Beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) -* [Youtube - How To Fork A GitHub Repo and Submit A Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) +
+ +**`Free-Programming-Books` में आपका स्वागत है!** + +हम नए योगदानकर्ताओं का स्वागत करते हैं; यहां तक ​​कि उन लोगों के लिए जो GitHub पर अपना पहला Pull Request (PR) करते हैं। यदि आप उनमें से एक हैं, तो यहां कुछ संसाधन हैं जो मदद कर सकते हैं: + +* [About Pull Requests](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) *(in english)* +* [Creating a pull request](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 Tutorial For Beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) *(in english)* +* [YouTube - How To Fork A GitHub Repo and Submit A Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(in english)* +* [YouTube - Markdown Crash Course](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. + +
+Click to see the growth users vs. time graphs. + +[![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) -सवाल पूछने में संकोच न करें; हर योगदानकर्ता ने पहले PR के साथ शुरुआत की। आप हमारे हजारवें हो सकते हैं! +
-यहां तक कि अगर आप एक अनुभवी ओपन सोर्स योगदानकर्ता हैं, तो ऐसी चीजें हैं जो आपको यात्रा कर सकती हैं। एक बार जब आप अपना पीआर सबमिट कर देते हैं, तो गिथब एक्शन एक लिंटर चलाएगा, अक्सर रिक्ति या वर्णमाला के साथ छोटे मुद्दों को ढूंढता है। यदि आपको एक हरा बटन मिलता है, तो सब कुछ समीक्षा के लिए तैयार है, लेकिन यदि नहीं, तो यह जानने के लिए फेल्ड चेक के नीचे "डिटेल्स" पर क्लिक करें कि लिंटर को क्या पसंद नहीं आया। समस्या को ठीक करें और अपने पीआर के लिए एक प्रतिबद्धता जोड़ें। +यहां तक कि अगर आप एक अनुभवी ओपन सोर्स योगदानकर्ता हैं, तो ऐसी चीजें हैं जो आपको यात्रा कर सकती हैं। एक बार जब आप अपना PR सबमिट कर देते हैं, तो ***GitHub Actions* एक *linter* चलाएगा, अक्सर रिक्ति या वर्णमाला के साथ छोटे मुद्दों को ढूंढता है**। यदि आपको एक हरा बटन मिलता है, तो सब कुछ समीक्षा के लिए तैयार है, लेकिन यदि नहीं, तो यह जानने के लिए फेल्ड चेक के नीचे "डिटेल्स" पर क्लिक करें कि लिंटर को क्या पसंद नहीं आया। समस्या को ठीक करें और अपने PR के लिए एक प्रतिबद्धता जोड़ें। -अंत में, यदि आप सुनिश्चित नहीं हैं कि जिस संसाधन को आप जोड़ना चाहते हैं, वह फ्री-प्रोग्रामिंग-बुक्स के लिए उपयुक्त है,[CONTRIBUTING](CONTRIBUTING.md) में दिशानिर्देशों के माध्यम से पढ़ें।. ([translations](README.md#translations)) +अंत में, यदि आप सुनिश्चित नहीं हैं कि जिस संसाधन को आप जोड़ना चाहते हैं, वह `Free-Programming-Books` के लिए उपयुक्त है,[CONTRIBUTING](CONTRIBUTING.md) में दिशानिर्देशों के माध्यम से पढ़ें।. ([translations](README.md#translations)) diff --git a/docs/HOWTO-id.md b/docs/HOWTO-id.md index ee11611ec..878f1b107 100644 --- a/docs/HOWTO-id.md +++ b/docs/HOWTO-id.md @@ -1,16 +1,34 @@ +# How-To at a glance + +
+ *[Baca ini dalam bahasa lain](README.md#translations)* -Selamat datang di Free-Programming-Books! Kami menyambut kontributor baru; bahkan untuk mereka yang membuat pull request pertama kali di Github. Jika Anda adalah salah satunya, berikut adalah beberapa sumber yang mungkin bisa membantu: +
+ +**Selamat datang di `Free-Programming-Books`!** + +Kami menyambut kontributor baru; bahkan untuk mereka yang membuat Pull Request (PR) pertama kali di GitHub. Jika Anda adalah salah satunya, berikut adalah beberapa sumber yang mungkin bisa membantu: + +* [Tentang Pull Requests](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) *(Dalam Bahasa Inggris)* +* [Membuat sebuah pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) *(Dalam Bahasa Inggris)* +* [GitHub Hello World](https://docs.github.com/en/get-started/quickstart/hello-world) *(Dalam Bahasa Inggris)* +* [YouTube - GitHub Tutorial Untuk Pemula](https://www.youtube.com/watch?v=0fKg7e37bQE) *(Dalam Bahasa Inggris)* +* [YouTube - Cara Melakukan Fork Pada GitHub Repositori dan Mengirimkan Sebuah Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(Dalam Bahasa Inggris)* +* [YouTube - Kursus Kilat Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) *(Dalam Bahasa Inggris)* + + +Jangan ragu untuk bertanya; setiap kontributor memulainya dengan PR yang pertama. Anda bisa menjadi yang keseribu! So... why not join our [large, growing](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) community. + +
+Click to see the growth users vs. time graphs. + +[![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) -* [Tentang Pull Requests](https://help.github.com/articles/about-pull-requests/) (Dalam Bahasa Inggris) -* [Membuat sebuah pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) (Dalam Bahasa Inggris) -* [Github Hello World](https://guides.github.com/activities/hello-world/) (Dalam Bahasa Inggris) -* [Youtube - Github Tutorial Untuk Pemula](https://www.youtube.com/watch?v=0fKg7e37bQE) (Dalam Bahasa Inggris) -* [Youtube - Cara Melakukan Fork Pada Github Repositori dan Mengirimkan Sebuah Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) (Dalam Bahasa Inggris) -* [Youtube - Kursus Kilat Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) (Dalam Bahasa Inggris) +[![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) -Jangan ragu untuk bertanya; setiap kontributor memulainya dengan PR yang pertama. Anda bisa menjadi yang keseribu! +
-Bahkan jika Anda seorang kontributor open source yang berpengalaman, ada hal-hal yang mungkin membuat Anda bingung. Setelah Anda mengirimkan PR Anda, GitHub Actions akan menjalankan linter, dan sering sekali menemukan sedikit masalah dengan spasi atau abjad. Jika Anda mendapatkan tombol hijau, semuanya siap untuk ditinjau, tetapi jika tidak, klik "Detail" di bawah centang yang gagal untuk mengetahui apa yang tidak disukai linter. Perbaiki masalah dan tambahkan commit ke PR Anda. +Bahkan jika Anda seorang kontributor open source yang berpengalaman, ada hal-hal yang mungkin membuat Anda bingung. Setelah Anda mengirimkan PR Anda, ***GitHub Actions* akan menjalankan *linter*, dan sering sekali menemukan sedikit masalah dengan spasi atau abjad**. Jika Anda mendapatkan tombol hijau, semuanya siap untuk ditinjau, tetapi jika tidak, klik "Detail" di bawah centang yang gagal untuk mengetahui apa yang tidak disukai linter. Perbaiki masalah dan tambahkan commit ke PR Anda. -Terakhir, jika Anda tidak yakin bahwa sumber daya yang ingin Anda tambahkan sesuai untuk Buku Pemrograman Gratis, bacalah panduan di [BERKONTRIBUSI](CONTRIBUTING-id.md). ([translations](README.md#translations)) +Terakhir, jika Anda tidak yakin bahwa sumber daya yang ingin Anda tambahkan sesuai untuk `Free-Programming-Books`, bacalah panduan di [BERKONTRIBUSI](CONTRIBUTING-id.md). ([translations](README.md#translations)) diff --git a/docs/HOWTO-it.md b/docs/HOWTO-it.md index d8e1fab00..c3e9373fb 100644 --- a/docs/HOWTO-it.md +++ b/docs/HOWTO-it.md @@ -1,17 +1,34 @@ +# Primi passi + +
+ *[Leggilo in altre lingue](README.md#translations)* -Benvenuto su Free-Programming-Books! Diamo il benvenuto ai nuovi collaboratori; anche a quelli che fanno la loro prima pull request su Github. Se sei uno di quelli, ecco qualche risorsa che potrebbe aiutarti: +
+ +**Benvenuto su `Free-Programming-Books`!** + +Diamo il benvenuto ai nuovi collaboratori; anche a quelli che fanno la loro prima Pull Request (PR) su GitHub. Se sei uno di quelli, ecco qualche risorsa che potrebbe aiutarti: + +* [Riguardante le Pull Requests](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) *(in inglese)* +* [Creare una pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) *(in inglese)* +* [GitHub Hello World](https://docs.github.com/en/get-started/quickstart/hello-world) *(in inglese)* +* [YouTube - GitHub Tutorial per Principianti](https://www.youtube.com/watch?v=0fKg7e37bQE) *(in inglese)* +* [YouTube - Come forkare una Repository GitHub e Inviare una Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(in inglese)* +* [YouTube - Corso accelerato di Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) *(in inglese)* + + +Non esitare a fare domande; ogni collaboratore ha iniziato con una prima PR. Quindi... perché non unirti alla nostra [grande e in crescita](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) community? + +
+Clicca per visualizzare i grafici temporali sulla crescita degli utenti. -* [Riguardante le Pull Requests](https://help.github.com/articles/about-pull-requests/) *(in inglese)* -* [Creare una pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) *(in inglese)* -* [Github Hello World](https://guides.github.com/activities/hello-world/) *(in inglese)* -* [Youtube - Github Tutorial per Principianti](https://www.youtube.com/watch?v=0fKg7e37bQE) *(in inglese)* -* [Youtube - Come forkare una Repository Github e Inviare una Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(in inglese)* -* [Youtube - Corso accelerato di Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) *(in inglese)* +[![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) -Non esitare a fare domande; ogni collaboratore iniziato con una prima pull request (PR). Potresti essere il nostro millesimo collaboratore. +
-Anche se sei un collaboratore esperto in ambito open source, queste sono cose che potrebbero crearti dei problemi. Una volta che hai inviato la tua PR, Github Actions avvierà un linter, spesso trovando piccoli problemi di spaziatura o di ordinamento alfabetico. Se ottieni una spunta verde, tutto è pronto per una revisione, ma se non è così clicca su "Details" sotto il check che è stato fallito, analizza l'errore, risolvilo e aggiungi un commit alla PR. +Anche se sei un collaboratore esperto in ambito open source, queste sono cose che potrebbero crearti dei problemi. Una volta che hai inviato la tua PR, ***GitHub Actions* avvierà un *linter*, spesso trovando piccoli problemi di spaziatura o di ordinamento alfabetico**. Se ottieni una spunta verde, tutto è pronto per una revisione, in caso contrario così clicca su "Details" sotto il check fallito, analizza l'errore e aggiungi un commit risolutivo alla PR. -In fine, se non sei sicuro che la risorsa che vuoi aggiungere è appropiata a Free-Programming-Books, leggi le linee guida su [CONTRIBUTING](CONTRIBUTING-it.md). ([translations](README.md#translations)) +In fine, se non sei sicuro che la risorsa che vuoi aggiungere sia appropriata a `Free-Programming-Books`, leggi le linee guida su [CONTRIBUTING](CONTRIBUTING-it.md) ([tradotto anche in altre lingua](README.md#translations)). diff --git a/docs/HOWTO-km.md b/docs/HOWTO-km.md index e7a59c350..d4367b1e0 100644 --- a/docs/HOWTO-km.md +++ b/docs/HOWTO-km.md @@ -1,17 +1,34 @@ +# How-To at a glance + +
+ *[អានជាភាសាផ្សេងៗ](README.md#translations)* -ស្វាគមន៍មកកាន់ Free-Programming-Books! យើងរីករាយ ទទូល contributors ថ្មីៗ; ទោះបីវាជាការpull request ជាលើកដំបូងរបស់អ្នកក៏ដោយ. បើអ្នកទើបតែចាប់ផ្តើម contibute ដំបូង , ធនធានខាងក្រោមអាចជួយអ្នកបាន: +
+ +**ស្វាគមន៍មកកាន់ `Free-Programming-Books`!** + +យើងរីករាយ ទទូល contributors ថ្មីៗ; ទោះបីវាជាការPull Request (PR) ជាលើកដំបូងរបស់អ្នកក៏ដោយ នៅ GitHub ។. បើអ្នកទើបតែចាប់ផ្តើម contibute ដំបូង , ធនធានខាងក្រោមអាចជួយអ្នកបាន: + +* [អ្វីជា Pull Requests](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) *(in english)* +* [របៀបបង្កើត pull request](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 សម្រាប់អ្នកទើបចាប់ផ្តើម](https://www.youtube.com/watch?v=0fKg7e37bQE) *(in english)* +* [YouTube - របៀប Fork A GitHub Repo and Submit A Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(in english)* +* [YouTube - របៀបប្រើ Markdown Crash Course](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. + +
+Click to see the growth users vs. time graphs. -* [អ្វីជា Pull Requests](https://help.github.com/articles/about-pull-requests/) -* [របៀបបង្កើត pull request](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 សម្រាប់អ្នកទើបចាប់ផ្តើម](https://www.youtube.com/watch?v=0fKg7e37bQE) -* [Youtube - របៀប Fork A GitHub Repo and Submit A 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) -កុំខ្លាចក្នុងការសួរ; ពួកយើងទាំងអស់គ្នាចាប់ផ្តើមពីការបង្កើត PR ដំបូង. អ្នកក៏អាចជាអ្នកទី ១០០០ ផងដែរ! +
-ពេលអ្នកបង្កើត Pull request ដំបូង Github នឹងត្រួតពិនិត្រអោយអ្នកដោយប្រើ Linter ពេលវាចេញពណ័ខៀវមានន័យថាអ្នកអាចបង្កើត PR បាន ផ្ទុយទៅវិញអ្នកត្រូវកែជាមុនសិនដើម្បីបង្កើត PR ដោយចុចលើពាក្រ "Detail។ +Even if you're an experienced open source contributor, there are things that might trip you up. ពេលអ្នកបង្កើត PR ដំបូង ***GitHub Actions* នឹងត្រួតពិនិត្រអោយអ្នកដោយប្រើ *linter*, often finding little issues with spacing or alphabetization**។. ពេលវាចេញពណ័ខៀវមានន័យថាអ្នកអាចបង្កើត PR បាន ផ្ទុយទៅវិញអ្នកត្រូវកែជាមុនសិនដើម្បីបង្កើត PR ដោយចុចលើពាក្រ "Detail។ -ចុងបញ្ចប់ បើអ្នកអត់ច្បាស់ថា ធនធានរបស់អ្នក ជា "free-programming-books" ឬអត់ ចូរអ្នកអានបន្ថែមទីនេះ [CONTRIBUTING](CONTRIBUTING.md)។ ([translations](README.md#translations)) +ចុងបញ្ចប់ បើអ្នកអត់ច្បាស់ថា ធនធានរបស់អ្នក ជា `Free-Programming-Books` ឬអត់ ចូរអ្នកអានបន្ថែមទីនេះ [CONTRIBUTING](CONTRIBUTING.md)។ ([translations](README.md#translations)) diff --git a/docs/HOWTO-ko.md b/docs/HOWTO-ko.md index e884a3585..1c2eae23f 100644 --- a/docs/HOWTO-ko.md +++ b/docs/HOWTO-ko.md @@ -1,17 +1,34 @@ +# How-To at a glance + +
+ *[다른언어](README.md#translations)* -Free-Programming-Books 에 오신 것을 환영합니다! 우리는 Github 에 첫 Pull-request 를 분들을 포함한 새로운 기여자들을 환영합니다. 다음 리소스들은 당신에게 도움이 될 수 있습니다: +
+ +**`Free-Programming-Books` 에 오신 것을 환영합니다!** + +우리는 Github 에 첫 Pull Request (PR) 를 보내주시는 신입 기여자들을 환영합니다. 다음 리소스들은 당신에게 도움이 될 수 있습니다: + +* [About Pull Requests](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) *(in english)* +* [Creating a pull request](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 Tutorial For Beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) *(in english)* +* [YouTube - How To Fork A GitHub Repo and Submit A Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(in english)* +* [YouTube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo) *(in english)* + + +주저하지 말고 질문하세요. 모든 기여자들 역시 첫 PR 로 시작했습니다. 당신은 우리의 1000번째가 될 수도 있어요! So... why not join our [large, growing](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) community. + +
+Click to see the growth users vs. time graphs. -* [About Pull Requests](https://help.github.com/articles/about-pull-requests/) -* [Creating a pull request](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 Tutorial For Beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) -* [Youtube - How To Fork A GitHub Repo and Submit A 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) -주저하지 말고 질문하세요. 모든 기여자들 역시 첫 Pull-request 로 시작했습니다. 당신은 우리의 1000번째가 될 수도 있어요! +
-경험 많은 오픈 소스 기여자라 할지라도, 여러분을 곤란하게 만들 수 있는 것들이 있습니다. 일단 PR을 제출하면 GitHub Actions는 띄어쓰기나 알파벳 순으로 작은 문제를 발견하는 작업을 실행합니다. 녹색 단추가 나타나면 모든 항목을 검토할 준비가 되어 있지만 그렇지 않으면 검사에서 "상세 정보"를 클릭합니다. 문제를 해결하고 PR에 커밋을 추가합니다. +경험 많은 오픈 소스 기여자라 할지라도, 여러분을 곤란하게 만들 수 있는 것들이 있습니다. 일단 PR을 제출하면 ***GitHub Actions*는 띄어쓰기나 알파벳 순으로 작은 문제를 발견하는 작업을 실행합니다**. 녹색 단추가 나타나면 모든 항목을 검토할 준비가 되어 있지만 그렇지 않으면 검사에서 "상세 정보"를 클릭합니다. 문제를 해결하고 PR에 커밋을 추가합니다. -마지막으로 추가하려는 리소스가 Free-Programming-Books에 적합한지 확실하지 않은 경우 [CONTRIBUTING](CONTRIBUTING-ko.md)의 지침을 확인십시오. ([translations](README.md#translations)) +마지막으로 추가하려는 리소스가 `Free-Programming-Books`에 적합한지 확실하지 않은 경우 [CONTRIBUTING](CONTRIBUTING-ko.md)의 지침을 확인십시오. ([translations](README.md#translations)) diff --git a/docs/HOWTO-nl.md b/docs/HOWTO-nl.md index 4a853d74f..f79e03304 100644 --- a/docs/HOWTO-nl.md +++ b/docs/HOWTO-nl.md @@ -1,17 +1,34 @@ +# How-To at a glance + +
+ *[Lees dit in andere talen](README.md#translations)* -Welkom bij Free-Programming-Books! We verwelkomen nieuwe bijdragers; zelfs degenen die hun allereerste pull-verzoeken doen. Als je een van hen bent, zijn hier enkele bronnen die je kunnen helpen: +
+ +**Welkom bij `Free-Programming-Books`!** + +We verwelkomen nieuwe bijdragers; zelfs degenen die hun allereerste Pull Request (PR) op GitHub doen. Als je een van hen bent, zijn hier enkele bronnen die je kunnen helpen: + +* [Over pull-verzoeken](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) *(in engels)* +* [Een pull-verzoek maken](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) *(in engels)* +* [GitHub Hallo Wereld](https://docs.github.com/en/get-started/quickstart/hello-world) *(in engels)* +* [YouTube - GitHub-zelfstudie voor beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) *(in engels)* +* [YouTube - Hoe een GitHub-repo te forken en een pull-verzoek in te dienen](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(in engels)* +* [YouTube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo) *(in engels)* + + +Aarzel niet om vragen te stellen; elke bijdrager begon met een eerste PR. Je zou onze duizendste kunnen zijn! So... why not join our [large, growing](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) community. + +
+Click to see the growth users vs. time graphs. -* [:us: Over pull-verzoeken](https://help.github.com/articles/about-pull-requests/) *(in engels)* -* [:us: Een pull-verzoek maken](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) *(in engels)* -* [:us: Github Hallo Wereld](https://guides.github.com/activities/hello-world/) *(in engels)* -* [:us: Youtube - Github-zelfstudie voor beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) *(in engels)* -* [:us: Youtube - Hoe een GitHub-repo te forken en een pull-verzoek in te dienen](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(in engels)* -* [:us: Youtube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo) *(in engels)* +[![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) -Aarzel niet om vragen te stellen; elke bijdrager begon met een eerste PR. Je zou onze duizendste kunnen zijn! +
-Zelfs als je een ervaren open source-bijdrager bent, zijn er dingen die je kunnen laten struikelen. Nadat je je PR hebt ingediend, voert GitHub Actions een linter uit, waarbij vaak kleine problemen met spatiëring of alfabetisering worden gevonden. Als je een groene knop krijgt, is alles klaar voor beoordeling, maar als dat niet het geval is, klik je op "Details" onder het vinkje dat niet heeft kunnen achterhalen wat de linter niet leuk vond. Los het probleem op en voeg een commit toe aan je PR. +Zelfs als je een ervaren open source-bijdrager bent, zijn er dingen die je kunnen laten struikelen. Nadat je je PR hebt ingediend, voert ***GitHub Actions* een *linter* uit, waarbij vaak kleine problemen met spatiëring of alfabetisering worden gevonden**. Als je een groene knop krijgt, is alles klaar voor beoordeling, maar als dat niet het geval is, klik je op "Details" onder het vinkje dat niet heeft kunnen achterhalen wat de linter niet leuk vond. Los het probleem op en voeg een commit toe aan je PR. -Tot slot, als je niet zeker weet of de bron die je wilt toevoegen geschikt is voor Free-Programming-Books, lees dan de richtlijnen in [CONTRIBUTING](CONTRIBUTING.md). ([translations](README.md#translations)) +Tot slot, als je niet zeker weet of de bron die je wilt toevoegen geschikt is voor `Free-Programming-Books`, lees dan de richtlijnen in [CONTRIBUTING](CONTRIBUTING.md). ([translations](README.md#translations)) diff --git a/docs/HOWTO-pl.md b/docs/HOWTO-pl.md index 2f1ebeb08..bba68242b 100644 --- a/docs/HOWTO-pl.md +++ b/docs/HOWTO-pl.md @@ -1,16 +1,33 @@ +# How-To at a glance + +
+ *[Przeczytaj to w innych językach](README.md#translations)* -Witamy w *Free-Programming-Books*! Witamy nowych współtwórców; nawet tych, którzy robią swoje pierwsze żądanie ściągnięcia na Github. Jeśli jesteś jednym z nich, oto kilka zasobów, które mogą Ci pomóc: +
+ +**Witamy w `Free-Programming-Books`!** + +Witamy nowych współtwórców; nawet tych, którzy robią swoje pierwsze Pull Request (PR) na GitHub. Jeśli jesteś jednym z nich, oto kilka zasobów, które mogą Ci pomóc: + +* [About Pull Requests](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) *(po angielsku)* +* [Creating a pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) *(po angielsku)* +* [GitHub Hello World](https://docs.github.com/en/get-started/quickstart/hello-world) *(po angielsku)* +* [YouTube - GitHub Tutorial For Beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) *(po angielsku)* +* [YouTube - How To Fork A GitHub Repo and Submit A Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(po angielsku)* +* [YouTube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo) *(po angielsku)* + + +Nie wahaj się zadawać pytań; każdy kontrybutor zaczynał od pierwszego PR. Możesz być naszym tysięcznym! So... why not join our [large, growing](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) community. + +
+Click to see the growth users vs. time graphs. -* [About Pull Requests](https://help.github.com/articles/about-pull-requests/) (po angielsku) -* [Creating a pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) (po angielsku) -* [Github Hello World](https://guides.github.com/activities/hello-world/) (po angielsku) -* [Youtube - Github Tutorial For Beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) (po angielsku) -* [Youtube - How To Fork A GitHub Repo and Submit A Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) (po angielsku) -* [Youtube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo) (po angielsku) +[![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) -Nie wahaj się zadawać pytań; każdy kontrybutor zaczynał od pierwszego PR. Możesz być naszym tysięcznym! +
-Nawet jeśli jesteś doświadczonym współtwórcą open source, są rzeczy, które mogą Cię frapować. Po przesłaniu swojego PR, *GitHub Actions* uruchomi linter, często znajdując drobne problemy z odstępami lub alfabetyzacją. Jeśli pojawi się zielony przycisk, wszystko jest gotowe do przeglądu, ale jeśli nie, kliknij „Szczegóły” pod kontrolką, która pozwoli dowiedzieć się co nie spodobało się linterowi. Napraw problem i dodaj zatwierdzenie do swojego PR. -Na koniec, jeśli nie masz pewności, czy zasób, który chcesz dodać, jest odpowiedni dla *Free-Programming-Books*, przeczytaj wytyczne w [CONTRIBUTING](CONTRIBUTING-pl.md). ([translations](README.md#translations)) +Nawet jeśli jesteś doświadczonym współtwórcą open source, są rzeczy, które mogą Cię frapować. Po przesłaniu swojego PR, ***GitHub Actions* uruchomi *linter*, często znajdując drobne problemy z odstępami lub alfabetyzacją**. Jeśli pojawi się zielony przycisk, wszystko jest gotowe do przeglądu, ale jeśli nie, kliknij „Szczegóły” pod kontrolką, która pozwoli dowiedzieć się co nie spodobało się linterowi. Napraw problem i dodaj zatwierdzenie do swojego PR. +Na koniec, jeśli nie masz pewności, czy zasób, który chcesz dodać, jest odpowiedni dla `Free-Programming-Books`, przeczytaj wytyczne w [CONTRIBUTING](CONTRIBUTING-pl.md). ([translations](README.md#translations)) diff --git a/docs/HOWTO-pt_BR.md b/docs/HOWTO-pt_BR.md index a945d6b7e..e64b43f35 100644 --- a/docs/HOWTO-pt_BR.md +++ b/docs/HOWTO-pt_BR.md @@ -1,18 +1,34 @@ +# How-To at a glance + +
+ *[Leia em outras linguagens](README.md#translations)* -Seja bem-vindo(a) ao Free-Programming-Books (Livros de Programação Grátis)! Novos contribuidores são bem-vindos para nós; até mesmo aqueles fazendo seu primeiro pull request no Github. Se você é um deles, nós temos alguns recursos que podem ajudar: +
+ +**Seja bem-vindo(a) ao `Free-Programming-Books` (*Livros de Programação Grátis*)!** + +Novos contribuidores são bem-vindos para nós; até mesmo aqueles fazendo seu primeiro Pull Request (PR) no GitHub. Se você é um deles, nós temos alguns recursos que podem ajudar: + +* [Sobre pull requests](https://docs.github.com/pt/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) +* [Criando uma pull request](https://docs.github.com/pt/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/pt/get-started/quickstart/hello-world) +* [YouTube - GitHub Tutorial For Beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) *(em inglês)* +* [YouTube - How To Fork A GitHub Repo and Submit A Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(em inglês)* +* [YouTube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo) *(em inglês)* -* [Github Hello World](https://guides.github.com/activities/hello-world/) (em inglês) -* [Sobre pull requests](https://docs.github.com/pt/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/about-pull-requests) -* [Youtube - Github Tutorial For Beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) (em inglês) -* [Youtube - How To Fork A GitHub Repo and Submit A Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) (em inglês) +Não hesite em tirar suas dúvidas; todo contribuidor começou com um primeiro PR. Então... por que não se juntar à nossa comunidade [grande e crescente](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books). +
+Clique para ver o gráficos de crescimento (usuários x tempo) -Não hesite em tirar suas dúvidas; todo contribuidor começou com um primeiro PR. E você pode ser nosso milésimo! +[![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) -Mesmo se você tem experiência com contribuições open source, existem algumas coisas que você pode errar. Por isso, assim que você submeter seu PR, ele vai ser testado pelo GitHub Actions, e as vezes, serão encontrados problemas como espaçamento. Se você receber um botão verde, está tudo certo para uma revisão de PR. Caso contrário, clique em "Detalhes" para ver o problema encontrado. Arrume ele e adicione um commit ao PR. +
+Mesmo se você tem experiência com contribuições open source, existem algumas coisas que você pode errar. Por isso, assim que você submeter seu PR, ele **vai ser testado pelo *GitHub Actions*, e as vezes, serão encontrados problemas como espaçamento**. Se você receber um botão verde, está tudo certo para uma revisão de PR. Caso contrário, clique em "Detalhes" para ver o problema encontrado. Arrume ele e adicione um commit ao PR. -Finalmente, se você não tem certeza de que o material que você que quer adicionar é apropriado para o Free-Programming-Books, leia o guia em [CONTRIBUTING](CONTRIBUTING-pt_BR.md). ([translations](README.md#translations)) +Finalmente, se você não tem certeza de que o material que você que quer adicionar é apropriado para o `Free-Programming-Books`, leia o guia em [CONTRIBUTING](CONTRIBUTING-pt_BR.md). ([translations](README.md#translations)) diff --git a/docs/HOWTO-ru.md b/docs/HOWTO-ru.md index 59f999344..5cb1b8067 100644 --- a/docs/HOWTO-ru.md +++ b/docs/HOWTO-ru.md @@ -1,21 +1,38 @@ +# How-To at a glance + +
+ *[Доступно на других языках](README.md#translations)* -Добро пожаловать в Free-Programming-Books! Мы приветствуем новых участников; даже тех, кто делает свой самый первый пулреквест на Github. Если вы один из них, вот несколько ресурсов, которые могут вам помочь: +
+ +**Добро пожаловать в `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) *(на английском языке)* +* [Создание пулреквеста](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) *(на английском языке)* +* [GitHub Hello World](https://docs.github.com/en/get-started/quickstart/hello-world) *(на английском языке)* +* [YouTube - обучающий ролик по GitHub для новичков](https://www.youtube.com/watch?v=0fKg7e37bQE) *(на английском языке)* +* [YouTube - Как форкнуть GitHub репозиторий и отправить пулл реквест](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(на английском языке)* +* [YouTube - курс погружения в Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) *(на английском языке)* + +* [Pull request'ы на GitHub или Как мне внести изменения в чужой проект](https://habr.com/ru/post/125999/) +* [GitHub Hello World](http://bi0morph.github.io/hello-world/) +* [YouTube - Изучение GitHub в одном видео уроке за 15 минут](https://www.youtube.com/watch?v=JfpCicDUMKc) +* [YouTube - Markdown - пиши README без боли](https://www.youtube.com/watch?v=FFBTGdEMrQ4) + +Не стесняйтесь задавать вопросы; каждый участник начал с первого PR. Вы могли бы стать нашим тысячным! So... why not join our [large, growing](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) community. + +
+Click to see the growth users vs. time graphs. + +[![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://docs.github.com/en/free-pro-team@latest/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) -* [:us: Создание пулреквеста](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) -* [:us: Github Hello World](https://guides.github.com/activities/hello-world/) -* [:us: Youtube - обучающий ролик по Github для новичков](https://www.youtube.com/watch?v=0fKg7e37bQE) -* [:us: Youtube - Как форкнуть GitHub репозиторий и отправить пулл реквест](https://www.youtube.com/watch?v=G1I3HF4YWEw) -* [:us: Youtube - курс погружения в Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) +[![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) -* [:ru: Pull request'ы на GitHub или Как мне внести изменения в чужой проект](https://habr.com/ru/post/125999/) -* [:ru: Github Hello World](http://bi0morph.github.io/hello-world/) -* [:ru: Youtube - Изучение GitHub в одном видео уроке за 15 минут](https://www.youtube.com/watch?v=JfpCicDUMKc) -* [:ru: Youtube - Markdown - пиши README без боли](https://www.youtube.com/watch?v=FFBTGdEMrQ4) - -Не стесняйтесь задавать вопросы; каждый участник начал с первого PR. Вы могли бы стать нашим тысячным! +
-Даже если вы опытный участник проекта с открытым исходным кодом, есть вещи, которые могут вас сбить с толку. После того как вы отправите свой PR, GitHub Actions запустит линтер который часто находит небольшие проблемы с пробелами или алфавитным порядком. Если у вас появляется зеленая кнопка, все готово к проверке, а если нет, нажмите "Details" под проверкой, которая не смогла выяснить, что не понравилось линтеру. Устраните проблему и добавьте коммит в свой пулреквест. +Даже если вы опытный участник проекта с открытым исходным кодом, есть вещи, которые могут вас сбить с толку. После того как вы отправите свой PR, ***GitHub Actions* запустит *linter* который часто находит небольшие проблемы с пробелами или алфавитным порядком**. Если у вас появляется зеленая кнопка, все готово к проверке, а если нет, нажмите "Details" под проверкой, которая не смогла выяснить, что не понравилось линтеру. Устраните проблему и добавьте коммит в свой PR. -Наконец, если вы не уверены, что ресурс, который вы хотите добавить, подходит для Free-Programming-Books, прочтите рекомендации в [CONTRIBUTING](CONTRIBUTING-ru.md). ([translations](README.md#translations)) +Наконец, если вы не уверены, что ресурс, который вы хотите добавить, подходит для `Free-Programming-Books`, прочтите рекомендации в [CONTRIBUTING](CONTRIBUTING-ru.md). ([translations](README.md#translations)) diff --git a/docs/HOWTO-sl.md b/docs/HOWTO-sl.md index 4b693d948..ec1228a84 100644 --- a/docs/HOWTO-sl.md +++ b/docs/HOWTO-sl.md @@ -1,17 +1,34 @@ +# How-To at a glance + +
+ *[Preberite to v drugih jezikih](README.md#translations)* -Dobrodošli v zbirki Free-Programming-Books! Lepo pozdravljeni vsi novi programerji - tudi tisti, ki boste na Githubu ustvarili vaš prvi zahtevek potega (pull-request). Če ste eden izmed njih, vam pri tem lahko pomaga nekaj virov: +
+ +**Dobrodošli v zbirki `Free-Programming-Books`!** + +Lepo pozdravljeni vsi novi programerji - tudi tisti, ki boste na GitHubu ustvarili vaš prvi zahtevek potega (pull-request / PR). Če ste eden izmed njih, vam pri tem lahko pomaga nekaj virov: + +* [About Pull Requests](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) *(v angleškem jeziku)* +* [Creating a pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) *(v angleškem jeziku)* +* [GitHub Hello World](https://docs.github.com/en/get-started/quickstart/hello-world) *(v angleškem jeziku)* +* [YouTube - GitHub Tutorial For Beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) *(v angleškem jeziku)* +* [YouTube - How To Fork A GitHub Repo and Submit A Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(v angleškem jeziku)* +* [YouTube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo) *(v angleškem jeziku)* + + +Ne oklevajte in postavljajte vprašanja; vsak programer je enkrat začel s svojim prvim PR-om. Vi ste lahko naš tisoči! So... why not join our [large, growing](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) community. + +
+Click to see the growth users vs. time graphs. -* [About Pull Requests](https://help.github.com/articles/about-pull-requests/) -* [Creating a pull request](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 Tutorial For Beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) -* [Youtube - How To Fork A GitHub Repo and Submit A 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) -Ne oklevajte in postavljajte vprašanja; vsak programer je enkrat začel s svojim prvim PR-om. Vi ste lahko naš tisoči! +
-Tudi če ste izkušeni na področju programiranja odprte kode, se bodo zagotovo našle zadeve, ki vas lahko malce zaustavijo. Ko oddate PR, bo GitHub Actions zagnal pregledovalnik, ki pogosto najde manjše težave z razmikom ali abecedo. Če se vam prikaže zeleni gumb, je vse pripravljeno za pregled. Če se zeleni gumb ne prikaže, kliknite »Podrobnosti« pod kljukico, ki je ugotovila, kaj pregledovalniku ni bilo všeč. Odpravite težavo in dodajte zahtevo (commit) v PR. +Tudi če ste izkušeni na področju programiranja odprte kode, se bodo zagotovo našle zadeve, ki vas lahko malce zaustavijo. Ko oddate PR, bo ***GitHub Actions* zagnal pregledovalnik, ki pogosto najde manjše težave z razmikom ali abecedo**. Če se vam prikaže zeleni gumb, je vse pripravljeno za pregled. Če se zeleni gumb ne prikaže, kliknite »Podrobnosti« pod kljukico, ki je ugotovila, kaj pregledovalniku ni bilo všeč. Odpravite težavo in dodajte zahtevo (commit) v PR. -Če niste prepričani, da je vir, ki ga želite dodati, primeren za zbirko Free-Programming-Books, preberite smernice v [CONTRIBUTING](CONTRIBUTING.md). ([translations](README.md#translations)) +Če niste prepričani, da je vir, ki ga želite dodati, primeren za zbirko `Free-Programming-Books`, preberite smernice v [CONTRIBUTING](CONTRIBUTING.md). ([translations](README.md#translations)) diff --git a/docs/HOWTO-sv.md b/docs/HOWTO-sv.md index 9fe35bf4b..9308b497f 100644 --- a/docs/HOWTO-sv.md +++ b/docs/HOWTO-sv.md @@ -1,16 +1,36 @@ +# How-To at a glance + +
+ *[Läs detta på andra språk](README.md#translations)* -Välkommen till *Free-Programming-Books*! Vi välkomnar varmt nya medarbetare, även de som gör sin första Pull Request (PR) på GitHub. Om du är en av dem finns här några resurser som kan hjälpa dig: +
+ +**Välkommen till `Free-Programming-Books`!** + +Vi välkomnar varmt nya medarbetare, även de som gör sin första Pull Request (PR) på GitHub. Om du är en av dem finns här några resurser som kan hjälpa dig: + +* [Om Pull begäran](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) *(på engelska)* +* [Skama en Pull begäran](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) *(på engelska)* +* [GitHub Hej världen](https://docs.github.com/en/get-started/quickstart/hello-world) *(på engelska)* +* [YouTube - GitHub -handledning för nybörjare](https://www.youtube.com/watch?v=0fKg7e37bQE) *(på engelska)* +* [YouTube - Hur man gafflar ett GitHub -arkiv och skickar en pull -begäran](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(på engelska)* +* [YouTube - Curso intensivo de Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) *(på engelska)* + + +Var aldrig i tvivel, eller var rädd för att ställa frågor; varje bidragsgivare som du ser i förvaret började på sin tid med en första PR. Tänk om det är vår tusen-tusendel! So... why not join our [large, growing](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) community. + +
+Click to see the growth users vs. time graphs. + +[![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) -* [Om Pull begäran](https://help.github.com/articles/about-pull-requests/) *(på engelska)* -* [Skama en Pull begäran](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) *(på engelska)* -* [GitHub Hej världen](https://guides.github.com/activities/hello-world/) *(på engelska)* -* [Youtube - GitHub -handledning för nybörjare](https://www.youtube.com/watch?v=0fKg7e37bQE) *(på engelska)* -* [Youtube - Hur man gafflar ett GitHub -arkiv och skickar en pull -begäran](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(på engelska)* -* [Youtube - Curso intensivo de Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) *(på engelska)* +NOTE: Contribution spikes use to match with the [Hacktoberfest event](https://hacktoberfest.digitalocean.com) dates. -Var aldrig i tvivel, eller var rädd för att ställa frågor; varje bidragsgivare som du ser i förvaret började på sin tid med en första PR. Tänk om det är vår tusen-tusendel! +
-Om du har erfarenhet som bidragsgivare på andra projekt med öppen källkod finns det några saker du kan göra för att få det att fungera. När den skickats till PR, utför *GitHub Actions* en *linter*; som hittar en meny för att hitta små problem med utrymme, utrymme, syntax eller läskunnighet. Om denna slutliga integrationsprocess ska slutföras kommer ljuset och allt är klart för din granskning; men om inte, klicka på "Detaljer för detaljer" som ger det exakta genomsnittet av det du tappade. Lösningen på detta problem och summan av förändringarna i din PR innebär ett nytt engagemang. +Om du har erfarenhet som bidragsgivare på andra projekt med öppen källkod finns det några saker du kan göra för att få det att fungera. När den skickats till PR, utför ***GitHub Actions* en *linter*; som hittar en meny för att hitta små problem med utrymme, utrymme, syntax eller läskunnighet**. Om denna slutliga integrationsprocess ska slutföras kommer ljuset och allt är klart för din granskning; men om inte, klicka på "Detaljer för detaljer" som ger det exakta genomsnittet av det du tappade. Lösningen på detta problem och summan av förändringarna i din PR innebär ett nytt engagemang. -I slutändan, om det inte finns någon garanti för att resursen för vilket aggregatet används för *Gratisprogrammeringsböcker*, kan det definitivt hittas i [CONTRIBUTING](CONTRIBUTING.md). ([translations](README.md#translations)) +I slutändan, om det inte finns någon garanti för att resursen för vilket aggregatet används för `Free-Programming-Books`, kan det definitivt hittas i [CONTRIBUTING](CONTRIBUTING.md). ([translations](README.md#translations)) diff --git a/docs/HOWTO-th.md b/docs/HOWTO-th.md index 2d1907a07..b1e1bca73 100644 --- a/docs/HOWTO-th.md +++ b/docs/HOWTO-th.md @@ -1,16 +1,34 @@ +# How-To at a glance + +
+ *[อ่านไฟล์นี้ในภาษาอื่น](README.md#translations)* -ขอต้อนรับเข้าสู่ Free-Programming-Books! พวกเราขอต้อนรับ contributors ใหม่ทุกคน แม้ว่าคุณพึ่งจะเคยสร้าง pull request เป็นครั้งแรกบน Github หากคุณคือหนึ่งในนั้น ด้านล่างนี้คือแหล่งข้อมูลที่อาจจะเป็นประโยชน์: +
+ +**ขอต้อนรับเข้าสู่ `Free-Programming-Books`!** + +พวกเราขอต้อนรับ contributors ใหม่ทุกคน แม้ว่าคุณพึ่งจะเคยสร้าง Pull Request (PR) เป็นครั้งแรกบน GitHub หากคุณคือหนึ่งในนั้น ด้านล่างนี้คือแหล่งข้อมูลที่อาจจะเป็นประโยชน์: + +* [About Pull Requests](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) *(ในภาษาอังกฤษ)* +* [Creating a pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) *(ในภาษาอังกฤษ)* +* [GitHub Hello World](https://docs.github.com/en/get-started/quickstart/hello-world) *(ในภาษาอังกฤษ)* +* [YouTube - GitHub Tutorial For Beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) *(ในภาษาอังกฤษ)* +* [YouTube - How To Fork A GitHub Repo and Submit A Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(ในภาษาอังกฤษ)* +* [YouTube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo) *(ในภาษาอังกฤษ)* + + +อย่าลังเลที่จะถามคำถาม ทุกคนมี PR แรกกันทั้งนั้น คุณอาจจะเป็นหนึ่งในผู้ช่วยของเรา. So... why not join our [large, growing](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) community. + +
+Click to see the growth users vs. time graphs. + +[![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) -* [About Pull Requests](https://help.github.com/articles/about-pull-requests/) -* [Creating a pull request](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 Tutorial For Beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) -* [Youtube - How To Fork A GitHub Repo and Submit A 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 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) -อย่าลังเลที่จะถามคำถาม ทุกคนมี PR แรกกันทั้งนั้น คุณอาจจะเป็นหนึ่งในผู้ช่วยของเรา +
-แม้ว่าคุณจะเป็นคนที่มีประสบการณ์ในการร่วมพัฒนา Open Source แต่อาจจะมีบางเรื่องที่คุณยังไม่รู้ก็เป็นได้ เมื่อใดก็ตามที่คุณได้สร้าง PR ขึ้น GitHub Actions จะทำการตรวจสอบโค้ดด้วย linter สิ่งที่จะพบเจอได้บ่อยจะเป็นการเว้นช่องว่างหรือการเรียงลำดับอักษรที่ไม่ถูกต้อง หากคุณเห็นปุ่มสีเขียวหมายความว่าทุกอย่างพร้อมสำหรับการตรวจตรา แต่หากไม่ได้เป็นเช่นนั้น ให้กดที่ "Details" เพื่ิอดูว่าผิดพลาดที่จุดไหนจากการรัน linter แล้วทำการแก้ปัญหานั้นเพื่อดึง PR ขึ้นไปใหม่ +แม้ว่าคุณจะเป็นคนที่มีประสบการณ์ในการร่วมพัฒนา Open Source แต่อาจจะมีบางเรื่องที่คุณยังไม่รู้ก็เป็นได้ เมื่อใดก็ตามที่คุณได้สร้าง PR ขึ้น ***GitHub Actions* จะทำการตรวจสอบโค้ดด้วย *linter* สิ่งที่จะพบเจอได้บ่อยจะเป็นการเว้นช่องว่างหรือการเรียงลำดับอักษรที่ไม่ถูกต้อง** หากคุณเห็นปุ่มสีเขียวหมายความว่าทุกอย่างพร้อมสำหรับการตรวจตรา แต่หากไม่ได้เป็นเช่นนั้น ให้กดที่ "Details" เพื่ิอดูว่าผิดพลาดที่จุดไหนจากการรัน linter แล้วทำการแก้ปัญหานั้นเพื่อดึง PR ขึ้นไปใหม่ -สุดท้ายนี้ หากคุณไม่แน่ใจว่าแหล่งข้อมูลเหล่านั้นจะเหมาะสมกับ Free-Programming-Books หรือไม่ ให้อ่านไกด์ไลน์จากในนี้ [CONTRIBUTING](CONTRIBUTING.md). ([translations](README.md#translations)) +สุดท้ายนี้ หากคุณไม่แน่ใจว่าแหล่งข้อมูลเหล่านั้นจะเหมาะสมกับ `Free-Programming-Books` หรือไม่ ให้อ่านไกด์ไลน์จากในนี้ [CONTRIBUTING](CONTRIBUTING.md). ([translations](README.md#translations)) diff --git a/docs/HOWTO-tr.md b/docs/HOWTO-tr.md index c4220b4dc..72e9f35f9 100644 --- a/docs/HOWTO-tr.md +++ b/docs/HOWTO-tr.md @@ -1,18 +1,35 @@ +# How-To at a glance + +
+ *[Diğer dillerde okumak için](README.md#translations)* -Free-Programming-Books Hoş Geldiniz! GitHub'da ilk Çekme Talebini (PR) yapanlardan olsanız bile Katkıda bulunmak için yeni gelenleri memnuniyetle karşılıyoruz. Eğer onlardan biriyseniz, işte size yardımcı olabilecek bazı kaynaklar: +
+ +**`Free-Programming-Books` Hoş Geldiniz!** + +GitHub'da ilk Pull Request (PR) yapanlardan olsanız bile Katkıda bulunmak için yeni gelenleri memnuniyetle karşılıyoruz. Eğer onlardan biriyseniz, işte size yardımcı olabilecek bazı kaynaklar: + +* [Çekme İstekleri Hakkında](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) *(içinde ingilizce dilinde)* +* [Çekme isteği oluşturma](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) *(içinde ingilizce dilinde)* +* [GitHub Merhaba Dünya](https://docs.github.com/en/get-started/quickstart/hello-world) *(içinde ingilizce dilinde)* +* [YouTube - Yeni Başlayanlar İçin GitHub Eğitimi](https://www.youtube.com/watch?v=0fKg7e37bQE) *(içinde ingilizce dilinde)* +* [YouTube - Bir GitHub Repo Nasıl Çatallanır ve Bir Çekme Talebi Nasıl Gönderilir](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(içinde ingilizce dilinde)* +* [YouTube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo) *(içinde ingilizce dilinde)* + + +Soru sormaktan çekinmeyin; her katılımcı ilk bir PR ile başladı. Binincimiz olabilirsin! So... why not join our [large, growing](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) community. + +
+Click to see the growth users vs. time graphs. -* [:us: Çekme İstekleri Hakkında](https://help.github.com/articles/about-pull-requests/) *(içinde ingilizce dilinde)* -* [:us: Çekme isteği oluşturma](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) *(içinde ingilizce dilinde)* -* [:us: GitHub Merhaba Dünya](https://guides.github.com/activities/hello-world/) *(içinde ingilizce dilinde)* -* [:us: Youtube - Yeni Başlayanlar İçin GitHub Eğitimi](https://www.youtube.com/watch?v=0fKg7e37bQE) *(içinde ingilizce dilinde)* -* [:us: Youtube - Bir GitHub Repo Nasıl Çatallanır ve Bir Çekme Talebi Nasıl Gönderilir](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(içinde ingilizce dilinde)* -* [:us: Youtube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo) *(içinde ingilizce dilinde)* +[![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) -Soru sormaktan çekinmeyin; her katılımcı ilk bir PR ile başladı. Binincimiz olabilirsin! +
Deneyimli bir açık kaynak katılımcısı olsanız bile, sizi rahatsız edebilecek şeyler var. PR'nizi gönderdikten sonra, -GitHub Actions, genellikle boşluk veya alfabetik sıralama ile ilgili küçük sorunlar bularak bir linter çalıştırır. Yeşil bir düğme alırsanız, her şey gözden geçirilmeye hazırdır, ancak değilse, linter'in neyi sevmediğini bulmak için başarısız olan kontrolün altındaki "Details" ı tıklayın. Sorunu düzeltin ve PR'nize bir taahhüt ekleyin. +***GitHub Actions*, genellikle boşluk veya alfabetik sıralama ile ilgili küçük sorunlar bularak bir *linter* çalıştırır**. Yeşil bir düğme alırsanız, her şey gözden geçirilmeye hazırdır, ancak değilse, linter'in neyi sevmediğini bulmak için başarısız olan kontrolün altındaki "Details" ı tıklayın. Sorunu düzeltin ve PR'nize bir taahhüt ekleyin. -Nihayet, Eklemek istediğiniz kaynağın Free-Programming-Books için uygun olduğundan emin değilseniz, [CONTRIBUTING](CONTRIBUTING.md) bölümündeki yönergeleri okuyun. ([translations](README.md#translations)) +Nihayet, Eklemek istediğiniz kaynağın `Free-Programming-Books` için uygun olduğundan emin değilseniz, [CONTRIBUTING](CONTRIBUTING.md) bölümündeki yönergeleri okuyun. ([translations](README.md#translations)) diff --git a/docs/HOWTO-uk.md b/docs/HOWTO-uk.md index f6bcec0eb..1d725675e 100644 --- a/docs/HOWTO-uk.md +++ b/docs/HOWTO-uk.md @@ -1,16 +1,34 @@ +# How-To at a glance + +
+ *[Прочитати іншими мовами](README.md#translations)* -Ласкаво просимо до Free-Programming-Books! Вітаємо нових учасників, навіть тих, хто робить свій перший pull request на Github. Якщо Ви один із них, ці ресурси можуть Вам допомогти: +
+ +**Ласкаво просимо до `Free-Programming-Books`!** + +Вітаємо нових учасників, навіть тих, хто робить свій перший Pull Request (PR) на GitHub. Якщо Ви один із них, ці ресурси можуть Вам допомогти: + +* [Про Pull Requests](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) *(англійською мовою)* +* [Створення pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) *(англійською мовою)* +* [GitHub Hello World](https://docs.github.com/en/get-started/quickstart/hello-world) *(англійською мовою)* +* [YouTube - GitHub для початківців](https://www.youtube.com/watch?v=0fKg7e37bQE) *(англійською мовою)* +* [YouTube - Як зробити Fork репозиторія GitHub та відправити Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(англійською мовою)* +* [YouTube - Занурення у Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) *(англійською мовою)* + + +Не соромтеся задавати питання, адже кожен дописувач починав з першого PR. Саме Ви можете стати нашим тисячним! So... why not join our [large, growing](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) community. + +
+Click to see the growth users vs. time graphs. + +[![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: Про Pull Requests](https://help.github.com/articles/about-pull-requests/) -* [:us: Створення pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) -* [:us: Github Hello World](https://guides.github.com/activities/hello-world/) -* [:us: Youtube - Github для початківців](https://www.youtube.com/watch?v=0fKg7e37bQE) -* [:us: Youtube - Як зробити Fork репозиторія GitHub та відправити Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) -* [:us: Youtube - Занурення у Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) +[![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) -Не соромтеся задавати питання, адже кожен дописувач починав з першого Pull Request. Саме Ви можете стати нашим тисячним! +
-Навіть якщо у Вас є досвід роботи з відкритим кодом, є речі, які можуть Вас збентежити. Після того, як Ви подасте свій PR, GitHub Actions запустить лінтер, який може виявити невеликі проблеми з пробілами або алфавітом. Якщо Ви отримаєте зелену кнопку, то все готово до перегляду, якщо ні, натисніть «Деталі» під перевіркою,щоб дізнатися що не сподобалося лінтеру. Вирішіть проблему та додайте комміт до свого Pull Request. +Навіть якщо у Вас є досвід роботи з відкритим кодом, є речі, які можуть Вас збентежити. Після того, як Ви подасте свій PR, ***GitHub Actions* запустить *linter*, який може виявити невеликі проблеми з пробілами або алфавітом**. Якщо Ви отримаєте зелену кнопку, то все готово до перегляду, якщо ні, натисніть «Деталі» під перевіркою,щоб дізнатися що не сподобалося лінтеру. Вирішіть проблему та додайте комміт до свого PR. -На останок, якщо Ви не впевнені чи ресурс, який ви хочете додати, підходить для Free-Programming-Books, ознайомтеся з інструкціями в розділі [ДОДАТКИ](CONTRIBUTING.md). ([translations](README.md#translations)) +На останок, якщо Ви не впевнені чи ресурс, який ви хочете додати, підходить для `Free-Programming-Books`, ознайомтеся з інструкціями в розділі [ДОДАТКИ](CONTRIBUTING.md). ([translations](README.md#translations)) diff --git a/docs/HOWTO-vi.md b/docs/HOWTO-vi.md index 1db0b6087..7b6530687 100644 --- a/docs/HOWTO-vi.md +++ b/docs/HOWTO-vi.md @@ -1,16 +1,34 @@ +# How-To at a glance + +
+ *[Đọc tài liệu này bằng các ngôn ngữ khác](README.md#translations)* -Chào mừng tới Free-Programming-Books! Chúng tôi chào đón những người đóng góp mới, kể cả khi những người đóng góp lần đầu thực hiện trên Github. Nếu bạn là một trong số họ, đây là một số nguồn có thể giúp: +
+ +**Chào mừng tới `Free-Programming-Books`!** + +Chúng tôi chào đón những người đóng góp mới, kể cả khi những người đóng góp lần đầu thực hiện trên GitHub. Nếu bạn là một trong số họ, đây là một số nguồn có thể giúp: + +* [Giới thiệu về Pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) *(bằng Tiếng Anh)* +* [Tạo một Pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) *(bằng Tiếng Anh)* +* [GitHub Hello World](https://docs.github.com/en/get-started/quickstart/hello-world) *(bằng Tiếng Anh)* +* [YouTube - Giới thiệu GitHub cho người mới bắt đầu](https://www.youtube.com/watch?v=0fKg7e37bQE) *(bằng Tiếng Anh)* +* [YouTube - Làm thế nào để Fork một kho lưu trữ GitHub và gửi một Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(bằng Tiếng Anh)* +* [YouTube - Khóa học về Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) *(bằng Tiếng Anh)* + + +Đừng do dự khi đặt câu hỏi; mọi người đóng góp đã bắt đầu với Pull Request (PR) đầu tiên. Bạn có thể là người tiếp theo! So... why not join our [large, growing](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) community. + +
+Click to see the growth users vs. time graphs. + +[![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) -* [Giới thiệu về Pull request](https://help.github.com/articles/about-pull-requests/) *(bằng Tiếng Anh)* -* [Tạo một Pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) *(bằng Tiếng Anh)* -* [Github Hello World](https://guides.github.com/activities/hello-world/) *(bằng Tiếng Anh)* -* [Youtube - Giới thiệu Github cho người mới bắt đầu](https://www.youtube.com/watch?v=0fKg7e37bQE) *(bằng Tiếng Anh)* -* [Youtube - Làm thế nào để Fork một kho lưu trữ GitHub và gửi một Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(bằng Tiếng Anh)* -* [Youtube - Khóa học về Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) *(bằng Tiếng Anh)* +[![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) -Đừng do dự khi đặt câu hỏi; mọi người đóng góp đã bắt đầu với PR đầu tiên. Bạn có thể là người tiếp theo! +
-Nếu bạn là một người đóng góp có kinh nghiệm với mã nguồn mở, có nhiều điều bạn có thể phát triển. Một khi bạn gửi PR của bạn, Github Actions sẽ kiểm tra, thường tìm thấy những lỗi nhỏ với khoảng trống hoặc chính tả. Nếu bạn đặt tích xanh, mọi thứ đã sẵn sàng cho việc đánh giá, nếu không, nhấn vào "Details" dưới phần kiểm tra lỗi để tìm kiếm sai sót. Sửa vấn đề và thêm một commit tới PR của bạn. +Nếu bạn là một người đóng góp có kinh nghiệm với mã nguồn mở, có nhiều điều bạn có thể phát triển. Một khi bạn gửi PR của bạn, ***GitHub Actions* sẽ kiểm tra tra bằng cách sử dụng *linter*, thường tìm thấy những lỗi nhỏ với khoảng trống hoặc chính tả**. Nếu bạn đặt tích xanh, mọi thứ đã sẵn sàng cho việc đánh giá, nếu không, nhấn vào "Details" dưới phần kiểm tra lỗi để tìm kiếm sai sót. Sửa vấn đề và thêm một commit tới PR của bạn. -Cuối cùng, nếu bạn không chắc rằng nguồn bạn muốn thêm phù hợp cho Free-Programming-Books, đọc qua hướng dẫn trong [Đóng Góp](CONTRIBUTING-vi.md). ([translations](README.md#translations)) +Cuối cùng, nếu bạn không chắc rằng nguồn bạn muốn thêm phù hợp cho `Free-Programming-Books`, đọc qua hướng dẫn trong [Đóng Góp](CONTRIBUTING-vi.md). ([translations](README.md#translations)) diff --git a/docs/HOWTO-zh.md b/docs/HOWTO-zh.md index ece21305b..b7230151c 100644 --- a/docs/HOWTO-zh.md +++ b/docs/HOWTO-zh.md @@ -1,17 +1,34 @@ -*[阅读本文的其他语言版本](README.md#translations))* +# How-To at a glance -欢迎使用 Free-Programming-Books（免费编程书籍）！我们欢迎新的贡献者；即使是在 Github 上首次提出拉取请求的人。如果您是其中之一，那么以下资源可能会有所帮助： +
-* [关于拉取请求](https://docs.github.com/cn/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/about-pull-requests) -* [创建拉取请求](https://docs.github.com/cn/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 初学者教程](https://www.youtube.com/watch?v=0fKg7e37bQE) -* [Youtube —— 如何复刻 GitHub 仓库并提交拉取请求](https://www.youtube.com/watch?v=G1I3HF4YWEw) -* [Youtube —— Markdown 速成课程](https://www.youtube.com/watch?v=HUBNt18RFbo) +*[阅读本文的其他语言版本](README.md#translations)* +
-不要犹豫，提问题。每个贡献者都从第一个拉取请求开始。你可能是我们的千分之一！ +**欢迎使用 `Free-Programming-Books`（*免费编程书籍*）！** -即使您是经验丰富的开源贡献者，也有一些事情可能会让您绊倒。提交您的拉取请求后，GitHub Actions 会运行一个 linter（代码风格检测工具），经常发现间距或字母顺序方面的小问题。如果您获得绿色按钮，则说明一切准备就绪，但如果没有，请单击 "更多" 链接以查找 linter 不满意的地方。解决此问题并新增 commit 到您的拉取请求。 +我们欢迎新的贡献者；即使是在 GitHub 上首次提出 Pull Request (PR) 的人。如果您是其中之一，那么以下资源可能会有所帮助： -最后，如果不确定要添加的资源是否适用于 Free-Programming-Books（免费编程书籍），请通读 [CONTRIBUTING](CONTRIBUTING-zh.md) 中的基本准则。([translations](README.md#translations)) +* [关于拉取请求](https://docs.github.com/cn/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) +* [创建拉取请求](https://docs.github.com/cn/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) +* [GitHub Hello World 教程](https://docs.github.com/cn/get-started/quickstart/hello-world) +* [YouTube —— GitHub 初学者教程](https://www.youtube.com/watch?v=0fKg7e37bQE) *(用英语)* +* [YouTube —— 如何复刻 GitHub 仓库并提交拉取请求](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(用英语)* +* [YouTube —— Markdown 速成课程](https://www.youtube.com/watch?v=HUBNt18RFbo) *(用英语)* + + +不要犹豫，提问题。每个贡献者都从第一个 PR 开始。你可能是我们的千分之一！ So... why not join our [large, growing](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) community. + +
+Click to see the growth users vs. time graphs. + +[![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) + +
+ +即使您是经验丰富的开源贡献者，也有一些事情可能会让您绊倒。提交您的 PR 后，***GitHub Actions* 会运行一个 *linter*（代码风格检测工具），经常发现间距或字母顺序方面的小问题**。如果您获得绿色按钮，则说明一切准备就绪，但如果没有，请单击 "更多" 链接以查找 linter 不满意的地方。解决此问题并新增 commit 到您的 PR。 + +最后，如果不确定要添加的资源是否适用于 `Free-Programming-Books`（免费编程书籍），请通读 [CONTRIBUTING](CONTRIBUTING-zh.md) 中的基本准则。([translations](README.md#translations)) diff --git a/docs/HOWTO-zh_TW.md b/docs/HOWTO-zh_TW.md index 741c07c7b..5919949ed 100644 --- a/docs/HOWTO-zh_TW.md +++ b/docs/HOWTO-zh_TW.md @@ -1,18 +1,35 @@ +# How-To at a glance + +
+ *[閱讀本文的其他語言版本](README.md#translations)* -歡迎使用 Free-Programming-Books！我們歡迎新的貢獻者；即使是在 Github 上首次提出 pull request 的人。如果您是其中之一，那麼以下資源可能會對你有所幫助： +
+ +**歡迎使用 `Free-Programming-Books`！** + +我們歡迎新的貢獻者；即使是在 GitHub 上首次提出 Pull Request (PR) 的人。如果您是其中之一，那麼以下資源可能會對你有所幫助： + +* [關於 pull request](https://docs.github.com/cn/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) +* [建立 pull request](https://docs.github.com/cn/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) +* [GitHub Hello World](https://docs.github.com/cn/get-started/quickstart/hello-world) +* [YouTube - GitHub 初學者課程](https://www.youtube.com/watch?v=0fKg7e37bQE) *(用英語)* +* [YouTube - How To Fork A GitHub Repo and Submit A Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(用英語)* +* [YouTube - Markdown 速成教學](https://www.youtube.com/watch?v=HUBNt18RFbo) *(用英語)* + + +不要猶豫，儘管提問。每個貢獻者都是從第一個 PR 開始。您可能是我們的千分之一！ So... why not join our [large, growing](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) community. + +
+Click to see the growth users vs. time graphs. -* [關於 pull request](https://help.github.com/articles/about-pull-requests/) -* [建立 pull request](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 初學者課程](https://www.youtube.com/watch?v=0fKg7e37bQE) -* [Youtube - How To Fork A GitHub Repo and Submit A Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) -* [Youtube - Markdown 速成教學](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) -不要猶豫，儘管提問。每個貢獻者都是從第一個 PR 開始。您可能是我們的千分之一！ +
-即使您是經驗豐富的開源貢獻者，也有一些事情可能會讓您遭受失敗。提交您的 PR 後，GitHub Actions 會運行程式碼品質分析工具，有時會發現間距或字母順序方面的問題。如果您獲得綠色按鈕，則說明一切準備就緒，但如果沒有，請點擊 "更多" 連結以尋找程式碼品質分析工具不满意的地方。修正此問題並新增 commit 到您的 PR。 +即使您是經驗豐富的開源貢獻者，也有一些事情可能會讓您遭受失敗。提交您的 PR 後，***GitHub Actions* 會運行程式碼品質分析工具，有時會發現間距或字母順序方面的問題**。如果您獲得綠色按鈕，則說明一切準備就緒，但如果沒有，請點擊 "更多" 連結以尋找程式碼品質分析工具不满意的地方。修正此問題並新增 commit 到您的 PR。 -最後，如果不確定要添加的資源是否適合 Free-Programming-Books，請閱讀 [CONTRIBUTING](CONTRIBUTING-zh_TW.md) 中的指南。([translations](README.md#translations)) +最後，如果不確定要添加的資源是否適合 `Free-Programming-Books`，請閱讀 [CONTRIBUTING](CONTRIBUTING-zh_TW.md) 中的指南。([translations](README.md#translations)) diff --git a/docs/HOWTO.md b/docs/HOWTO.md index 231fdfcf8..e6f163802 100644 --- a/docs/HOWTO.md +++ b/docs/HOWTO.md @@ -1,17 +1,34 @@ +# How-To at a glance + +
+ *[Read this in other languages](README.md#translations)* -Welcome to Free-Programming-Books! We welcome new contributors; even those making their very first pull request on Github. If you're one of those, here are some resources that might help: +
+ +**Welcome to `Free-Programming-Books`!** + +We welcome new contributors; even those making their very first Pull Request (PR) on GitHub. If you're one of those, here are some resources that might help: + +* [About pull requests](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) +* [Creating a pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) +* [GitHub Hello World](https://docs.github.com/en/get-started/quickstart/hello-world) +* [YouTube - GitHub Tutorial For Beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) +* [YouTube - How To Fork A GitHub Repo and Submit A Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) +* [YouTube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo) + + +Don't hesitate to ask questions; every contributor started with a first PR. So... why not join our [large, growing](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) community. + +
+Click to see users vs. time graphs. -* [About Pull Requests](https://help.github.com/articles/about-pull-requests/) -* [Creating a pull request](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 Tutorial For Beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) -* [Youtube - How To Fork A GitHub Repo and Submit A 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) -Don't hesitate to ask questions; every contributor started with a first PR. So... why not join our [large, growing](https://contributor-graph-api.apiseven.com/contributors-svg?repo=EbookFoundation/free-programming-books) community. +
-Even if you're an experienced open source contributor, there are things that might trip you up. Once you've submitted your PR, GitHub Actions will run a linter, often finding little issues with spacing or alphabetization. If you get a green button, everything is ready for review, but if not, click "Details" under the check that failed to find out what the linter didn't like. Fix the problem and add a commit to your PR. +Even if you're an experienced open source contributor, there are things that might trip you up. Once you've submitted your PR, ***GitHub Actions* will run a *linter*, often finding little issues with spacing or alphabetization**. If you get a green button, everything is ready for review; but if not, click "Details" under the check that failed to find out what the linter didn't like, and fix the problem adding a new commit to the branch from which your PR was opened. -Finally, if you're not sure that the resource you want to add is appropriate for Free-Programming-Books, read through the guidelines in [CONTRIBUTING](CONTRIBUTING.md). ([translations](README.md#translations)) +Finally, if you're not sure that the resource you want to add is appropriate for `Free-Programming-Books`, read through the guidelines in [CONTRIBUTING](CONTRIBUTING.md) *([translations](README.md#translations) also available)*.