docs(howto): Homogenize HowTo's format across translated files (#6724)
* 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 7ee485bb3b 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: أحمد الطبراني <eltabaraniahmed@gmail.com>
* 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 <sondaniel.88@gmail.com>
* Fix korean typos
Co-authored-by: Wonjang Son <sondaniel.88@gmail.com>
* New strings translated to `ar` Arabic
Co-authored-by: أحمد الطبراني <eltabaraniahmed@gmail.com>
* New strings translated to `fr` French
Co-authored-by: Loic Beylot <loic.beylot@gmail.com>
Co-authored-by: أحمد الطبراني <eltabaraniahmed@gmail.com>
Co-authored-by: ImVector <59611597+LuigiImVector@users.noreply.github.com>
Co-authored-by: Wonjang Son <sondaniel.88@gmail.com>
Co-authored-by: Loic Beylot <loic.beylot@gmail.com>
pull/6740/head
David Ordás
3 years ago
committed by
GitHub
parent
47d53f8c96
commit
28ec79103b
27 changed files with 740 additions and 268 deletions
@ -1,17 +1,34 @@ |
||||
# How-To at a glance |
||||
|
||||
<div align="right" markdown="1"> |
||||
|
||||
*[Pročitaj ovo u drugim jezicima](README.md#translations)* |
||||
|
||||
Dobrodošli u Free-Programming-Books! Primamo nove kontributore; čak i one koji tek prave svoj prvi pull request na GitHub-u. Ako ste jedan od njih, ovdje je nekoliko izvora koji bi Vam mogli pomoći: |
||||
</div> |
||||
|
||||
**Dobrodošli u `Free-Programming-Books`!** |
||||
|
||||
Primamo nove kontributore; čak i one koji tek prave svoj prvi Pull Request (PR) na GitHub-u. Ako ste jedan od njih, ovdje je nekoliko izvora koji bi Vam mogli pomoći: |
||||
|
||||
* [O pull request-ima](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) *(in english)* |
||||
* [Kreiranje pull request-a](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) *(in english)* |
||||
* [GitHub Hello World](https://docs.github.com/en/get-started/quickstart/hello-world) *(in english)* |
||||
* [YouTube - GitHub tutorijal za početnike](https://www.youtube.com/watch?v=0fKg7e37bQE) *(in english)* |
||||
* [YouTube - Kako fork-ati GitHub repozitorij i postaviti pull request](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(in english)* |
||||
* [YouTube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo) *(in english)* |
||||
|
||||
|
||||
Namojte se ustručavati da postavljate pitanja; svaki kontributor je započeo sa prvim PR-om. So... why not join our [large, growing](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) community. |
||||
|
||||
<details align="center" markdown="1"> |
||||
<summary>Click to see the growth users vs. time graphs.</summary> |
||||
|
||||
* [O pull request-ima](https://help.github.com/articles/about-pull-requests/) |
||||
* [Kreiranje pull request-a](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) |
||||
* [GitHub Hello World](https://guides.github.com/activities/hello-world/) |
||||
* [YouTube - GitHub tutorijal za početnike](https://www.youtube.com/watch?v=0fKg7e37bQE) |
||||
* [YouTube - Kako fork-ati GitHub repozitorij i postaviti pull request](https://www.youtube.com/watch?v=G1I3HF4YWEw) |
||||
* [YouTube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo) |
||||
[](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) |
||||
|
||||
[](https://www.apiseven.com/en/contributor-graph?chart=contributorMonthlyActivity&repo=ebookfoundation/free-programming-books) |
||||
|
||||
Namojte se ustručavati da postavljate pitanja; svaki kontributor je započeo sa prvim PR-om. Vi biste mogli biti naš hiljaditi! |
||||
</details> |
||||
|
||||
Čak i ako ste iskusan open source kontributor, postoje stvari u kojma biste se mogli zapetljati. Nakon što ste postavili Vaš PR, GitHub Actions će pokrenuti linter, koji često pronalazi problemčiće sa proredom ili abecednim redoslijedom. Ako dobijete zeleno dugme, sve je spremno za pregled, u suprotnom, kliknite "Details" ispod provjere koja nije uspjela kako biste otkrili šta se linter-u nije svidjelo. Ispravite problem i dodajte commit Vašem PR-u. |
||||
Čak i ako ste iskusan open source kontributor, postoje stvari u kojma biste se mogli zapetljati. Nakon što ste postavili Vaš PR, ***GitHub Actions* će pokrenuti *linter*, koji često pronalazi problemčiće sa proredom ili abecednim redoslijedom**. Ako dobijete zeleno dugme, sve je spremno za pregled, u suprotnom, kliknite "Details" ispod provjere koja nije uspjela kako biste otkrili šta se linter-u nije svidjelo. Ispravite problem i dodajte commit Vašem PR-u. |
||||
|
||||
Na kraju, ako niste sigurni da je resurs koji želite dodati prikladan za Free-Programming-Books, pročitajte smjernice u [CONTRIBUTING](CONTRIBUTING.md). ([translations](README.md#translations)) |
||||
Na kraju, ako niste sigurni da je resurs koji želite dodati prikladan za `Free-Programming-Books`, pročitajte smjernice u [CONTRIBUTING](CONTRIBUTING.md). ([translations](README.md#translations)) |
||||
|
||||
@ -1,16 +1,33 @@ |
||||
# How-To at a glance |
||||
|
||||
<div align="right" markdown="1"> |
||||
|
||||
*[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: |
||||
</div> |
||||
|
||||
**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. |
||||
|
||||
<details align="center" markdown="1"> |
||||
<summary>Click to see the growth users vs. time graphs.</summary> |
||||
|
||||
[](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) |
||||
|
||||
[](https://www.apiseven.com/en/contributor-graph?chart=contributorMonthlyActivity&repo=ebookfoundation/free-programming-books) |
||||
|
||||
</details> |
||||
|
||||
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)) |
||||
|
||||
@ -1,17 +1,34 @@ |
||||
# How-To at a glance |
||||
|
||||
<div align="right" markdown="1"> |
||||
|
||||
*[Διαβάστε το σε διαφορετικές γλώσσες](README.md#translations)* |
||||
|
||||
Καλώς ήλθατε στο Free-Programming-Books! Καλωσορίζουμε τους νέους συνεισφέροντες· ακόμα και αυτούς που κάνουν το πρώτο τους pull request (PR) στο Github. Αν είστε ένας από αυτούς, ορίστε λίγο υλικό που μπορεί να βοηθήσει: |
||||
</div> |
||||
|
||||
**Καλώς ήλθατε στο `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. |
||||
|
||||
<details align="center" markdown="1"> |
||||
<summary>Click to see the growth users vs. time graphs.</summary> |
||||
|
||||
* [Σχετικά με τα 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) *(στα αγγλικά)* |
||||
[](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) |
||||
|
||||
[](https://www.apiseven.com/en/contributor-graph?chart=contributorMonthlyActivity&repo=ebookfoundation/free-programming-books) |
||||
|
||||
Μη διστάσετε να κάνετε ερωτήσεις· κάθε συνεισφέρων ξεκίνησε ένα πρώτο PR. Μπορεί να είστε το χιλιοστό μας! |
||||
</details> |
||||
|
||||
Ακόμα και αν είστε έμπειρος συνεισφέρων, υπάρχουν πράγματα που μπορεί να σας μπερδέψουν. Όταν έχετε υποβάλλει το 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)) |
||||
|
||||
@ -1,17 +1,34 @@ |
||||
# Primeros pasos |
||||
|
||||
<div align="right" markdown="1"> |
||||
|
||||
*[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: |
||||
</div> |
||||
|
||||
**¡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? |
||||
|
||||
<details align="center" markdown="1"> |
||||
<summary>Click para detalle gráfico sobre dicho crecimiento (usuarios vs. tiempo)</summary> |
||||
|
||||
* [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)* |
||||
[](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&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! |
||||
</details> |
||||
|
||||
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)). |
||||
|
||||
@ -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: |
||||
<div align="right" markdown="1"> |
||||
|
||||
* [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)* |
||||
|
||||
</div> |
||||
|
||||
**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. |
||||
<details align="center" markdown="1"> |
||||
<summary>Click to see the growth users vs. time graphs.</summary> |
||||
|
||||
[](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) |
||||
|
||||
[](https://www.apiseven.com/en/contributor-graph?chart=contributorMonthlyActivity&repo=ebookfoundation/free-programming-books) |
||||
|
||||
</details> |
||||
|
||||
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)) |
||||
|
||||
@ -1,15 +1,34 @@ |
||||
# Mode d'emploi en bref |
||||
|
||||
<div align="right" markdown="1"> |
||||
|
||||
*[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: |
||||
</div> |
||||
|
||||
**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. |
||||
<details align="center" markdown="1"> |
||||
<summary>Cliquez pour voir les graphiques de croissance des utilisateurs en fonction du temps.</summary> |
||||
|
||||
[](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) |
||||
|
||||
[](https://www.apiseven.com/en/contributor-graph?chart=contributorMonthlyActivity&repo=ebookfoundation/free-programming-books) |
||||
|
||||
</details> |
||||
|
||||
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)) |
||||
|
||||
@ -1,16 +1,34 @@ |
||||
# How-To at a glance |
||||
|
||||
<div align="right" markdown="1"> |
||||
|
||||
*[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: |
||||
</div> |
||||
|
||||
**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. |
||||
|
||||
<details align="center" markdown="1"> |
||||
<summary>Click to see the growth users vs. time graphs.</summary> |
||||
|
||||
[](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) |
||||
[](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! |
||||
</details> |
||||
|
||||
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)) |
||||
|
||||
@ -1,17 +1,34 @@ |
||||
# Primi passi |
||||
|
||||
<div align="right" markdown="1"> |
||||
|
||||
*[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: |
||||
</div> |
||||
|
||||
**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? |
||||
|
||||
<details align="center" markdown="1"> |
||||
<summary>Clicca per visualizzare i grafici temporali sulla crescita degli utenti.</summary> |
||||
|
||||
* [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)* |
||||
[](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&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. |
||||
</details> |
||||
|
||||
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)). |
||||
|
||||
@ -1,17 +1,34 @@ |
||||
# How-To at a glance |
||||
|
||||
<div align="right" markdown="1"> |
||||
|
||||
*[다른언어](README.md#translations)* |
||||
|
||||
Free-Programming-Books 에 오신 것을 환영합니다! 우리는 Github 에 첫 Pull-request 를 분들을 포함한 새로운 기여자들을 환영합니다. 다음 리소스들은 당신에게 도움이 될 수 있습니다: |
||||
</div> |
||||
|
||||
**`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. |
||||
|
||||
<details align="center" markdown="1"> |
||||
<summary>Click to see the growth users vs. time graphs.</summary> |
||||
|
||||
* [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) |
||||
[](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) |
||||
|
||||
[](https://www.apiseven.com/en/contributor-graph?chart=contributorMonthlyActivity&repo=ebookfoundation/free-programming-books) |
||||
|
||||
주저하지 말고 질문하세요. 모든 기여자들 역시 첫 Pull-request 로 시작했습니다. 당신은 우리의 1000번째가 될 수도 있어요! |
||||
</details> |
||||
|
||||
경험 많은 오픈 소스 기여자라 할지라도, 여러분을 곤란하게 만들 수 있는 것들이 있습니다. 일단 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)) |
||||
|
||||
@ -1,17 +1,34 @@ |
||||
# How-To at a glance |
||||
|
||||
<div align="right" markdown="1"> |
||||
|
||||
*[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: |
||||
</div> |
||||
|
||||
**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. |
||||
|
||||
<details align="center" markdown="1"> |
||||
<summary>Click to see the growth users vs. time graphs.</summary> |
||||
|
||||
* [: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)* |
||||
[](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&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! |
||||
</details> |
||||
|
||||
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)) |
||||
|
||||
@ -1,16 +1,33 @@ |
||||
# How-To at a glance |
||||
|
||||
<div align="right" markdown="1"> |
||||
|
||||
*[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: |
||||
</div> |
||||
|
||||
**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. |
||||
|
||||
<details align="center" markdown="1"> |
||||
<summary>Click to see the growth users vs. time graphs.</summary> |
||||
|
||||
* [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) |
||||
[](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&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! |
||||
</details> |
||||
|
||||
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)) |
||||
|
||||
@ -1,18 +1,34 @@ |
||||
# How-To at a glance |
||||
|
||||
<div align="right" markdown="1"> |
||||
|
||||
*[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: |
||||
</div> |
||||
|
||||
**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). |
||||
|
||||
<details align="center" markdown="1"> |
||||
<summary>Clique para ver o gráficos de crescimento (usuários x tempo)</summary> |
||||
|
||||
Não hesite em tirar suas dúvidas; todo contribuidor começou com um primeiro PR. E você pode ser nosso milésimo! |
||||
[](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&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. |
||||
</details> |
||||
|
||||
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)) |
||||
|
||||
@ -1,21 +1,38 @@ |
||||
# How-To at a glance |
||||
|
||||
<div align="right" markdown="1"> |
||||
|
||||
*[Доступно на других языках](README.md#translations)* |
||||
|
||||
Добро пожаловать в Free-Programming-Books! Мы приветствуем новых участников; даже тех, кто делает свой самый первый пулреквест на Github. Если вы один из них, вот несколько ресурсов, которые могут вам помочь: |
||||
</div> |
||||
|
||||
**Добро пожаловать в `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. |
||||
|
||||
<details align="center" markdown="1"> |
||||
<summary>Click to see the growth users vs. time graphs.</summary> |
||||
|
||||
[](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) |
||||
[](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. Вы могли бы стать нашим тысячным! |
||||
</details> |
||||
|
||||
Даже если вы опытный участник проекта с открытым исходным кодом, есть вещи, которые могут вас сбить с толку. После того как вы отправите свой 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)) |
||||
|
||||
@ -1,17 +1,34 @@ |
||||
# How-To at a glance |
||||
|
||||
<div align="right" markdown="1"> |
||||
|
||||
*[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: |
||||
</div> |
||||
|
||||
**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. |
||||
|
||||
<details align="center" markdown="1"> |
||||
<summary>Click to see the growth users vs. time graphs.</summary> |
||||
|
||||
* [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) |
||||
[](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&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! |
||||
</details> |
||||
|
||||
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)) |
||||
|
||||
@ -1,16 +1,36 @@ |
||||
# How-To at a glance |
||||
|
||||
<div align="right" markdown="1"> |
||||
|
||||
*[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: |
||||
</div> |
||||
|
||||
**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. |
||||
|
||||
<details align="center" markdown="1"> |
||||
<summary>Click to see the growth users vs. time graphs.</summary> |
||||
|
||||
[](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&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! |
||||
</details> |
||||
|
||||
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)) |
||||
|
||||
@ -1,18 +1,35 @@ |
||||
# How-To at a glance |
||||
|
||||
<div align="right" markdown="1"> |
||||
|
||||
*[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: |
||||
</div> |
||||
|
||||
**`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. |
||||
|
||||
<details align="center" markdown="1"> |
||||
<summary>Click to see the growth users vs. time graphs.</summary> |
||||
|
||||
* [: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)* |
||||
[](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&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! |
||||
</details> |
||||
|
||||
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)) |
||||
|
||||
@ -1,16 +1,34 @@ |
||||
# How-To at a glance |
||||
|
||||
<div align="right" markdown="1"> |
||||
|
||||
*[Прочитати іншими мовами](README.md#translations)* |
||||
|
||||
Ласкаво просимо до Free-Programming-Books! Вітаємо нових учасників, навіть тих, хто робить свій перший pull request на Github. Якщо Ви один із них, ці ресурси можуть Вам допомогти: |
||||
</div> |
||||
|
||||
**Ласкаво просимо до `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. |
||||
|
||||
<details align="center" markdown="1"> |
||||
<summary>Click to see the growth users vs. time graphs.</summary> |
||||
|
||||
[](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) |
||||
[](https://www.apiseven.com/en/contributor-graph?chart=contributorMonthlyActivity&repo=ebookfoundation/free-programming-books) |
||||
|
||||
Не соромтеся задавати питання, адже кожен дописувач починав з першого Pull Request. Саме Ви можете стати нашим тисячним! |
||||
</details> |
||||
|
||||
Навіть якщо у Вас є досвід роботи з відкритим кодом, є речі, які можуть Вас збентежити. Після того, як Ви подасте свій 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)) |
||||
|
||||
@ -1,16 +1,34 @@ |
||||
# How-To at a glance |
||||
|
||||
<div align="right" markdown="1"> |
||||
|
||||
*[Đọ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: |
||||
</div> |
||||
|
||||
**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. |
||||
|
||||
<details align="center" markdown="1"> |
||||
<summary>Click to see the growth users vs. time graphs.</summary> |
||||
|
||||
[](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)* |
||||
[](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! |
||||
</details> |
||||
|
||||
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)) |
||||
|
||||
@ -1,17 +1,34 @@ |
||||
*[阅读本文的其他语言版本](README.md#translations))* |
||||
# How-To at a glance |
||||
|
||||
欢迎使用 Free-Programming-Books（免费编程书籍）！我们欢迎新的贡献者；即使是在 Github 上首次提出拉取请求的人。如果您是其中之一，那么以下资源可能会有所帮助： |
||||
<div align="right" markdown="1"> |
||||
|
||||
* [关于拉取请求](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)* |
||||
|
||||
</div> |
||||
|
||||
不要犹豫，提问题。每个贡献者都从第一个拉取请求开始。你可能是我们的千分之一！ |
||||
**欢迎使用 `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. |
||||
|
||||
<details align="center" markdown="1"> |
||||
<summary>Click to see the growth users vs. time graphs.</summary> |
||||
|
||||
[](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) |
||||
|
||||
[](https://www.apiseven.com/en/contributor-graph?chart=contributorMonthlyActivity&repo=ebookfoundation/free-programming-books) |
||||
|
||||
</details> |
||||
|
||||
即使您是经验丰富的开源贡献者，也有一些事情可能会让您绊倒。提交您的 PR 后，***GitHub Actions* 会运行一个 *linter*（代码风格检测工具），经常发现间距或字母顺序方面的小问题**。如果您获得绿色按钮，则说明一切准备就绪，但如果没有，请单击 "更多" 链接以查找 linter 不满意的地方。解决此问题并新增 commit 到您的 PR。 |
||||
|
||||
最后，如果不确定要添加的资源是否适用于 `Free-Programming-Books`（免费编程书籍），请通读 [CONTRIBUTING](CONTRIBUTING-zh.md) 中的基本准则。([translations](README.md#translations)) |
||||
|
||||
@ -1,18 +1,35 @@ |
||||
# How-To at a glance |
||||
|
||||
<div align="right" markdown="1"> |
||||
|
||||
*[閱讀本文的其他語言版本](README.md#translations)* |
||||
|
||||
歡迎使用 Free-Programming-Books！我們歡迎新的貢獻者；即使是在 Github 上首次提出 pull request 的人。如果您是其中之一，那麼以下資源可能會對你有所幫助： |
||||
</div> |
||||
|
||||
**歡迎使用 `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. |
||||
|
||||
<details align="center" markdown="1"> |
||||
<summary>Click to see the growth users vs. time graphs.</summary> |
||||
|
||||
* [關於 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) |
||||
[](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) |
||||
|
||||
[](https://www.apiseven.com/en/contributor-graph?chart=contributorMonthlyActivity&repo=ebookfoundation/free-programming-books) |
||||
|
||||
不要猶豫，儘管提問。每個貢獻者都是從第一個 PR 開始。您可能是我們的千分之一！ |
||||
</details> |
||||
|
||||
即使您是經驗豐富的開源貢獻者，也有一些事情可能會讓您遭受失敗。提交您的 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)) |
||||
|
||||
@ -1,17 +1,34 @@ |
||||
# How-To at a glance |
||||
|
||||
<div align="right" markdown="1"> |
||||
|
||||
*[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: |
||||
</div> |
||||
|
||||
**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. |
||||
|
||||
<details align="center" markdown="1"> |
||||
<summary>Click to see users vs. time graphs.</summary> |
||||
|
||||
* [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) |
||||
[](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&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. |
||||
</details> |
||||
|
||||
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)*. |
||||
|
||||
Loading…
Reference in new issue