diff --git a/docs/HOWTO-es.md b/docs/HOWTO-es.md index 144a589a7..1e3d956fe 100644 --- a/docs/HOWTO-es.md +++ b/docs/HOWTO-es.md @@ -1,17 +1,34 @@ +# Primeros pasos + +
+ *[Lea esto en otros idiomas](../README.md#translations)* -¡Sea bienvenido a *Free-Programming-Books*! Damos una calurosa bienvenida a los nuevos colaboradores; incluso a aquellos que realizan su primera Pull Request (PR) en GitHub. Si es usted uno de ellos, aquí van algunos recursos que quizás le pueden ayudar: +
+ +**¡Sea bienvenido a `Free-Programming-Books`!** + +Le damos una calurosa bienvenida 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/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)* +* [GitHub Hola Mundo](https://docs.github.com/en/get-started/quickstart/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)* -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! +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? -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. +
+Detalles sobre dicho crecimiento -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)). +[![EbookFoundation/free-programming-books's Contributor over time Graph](https://contributor-overtime-api.apiseven.com/contributors-svg?chart=contributorOverTime&repo=ebookfoundation/free-programming-books)](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) + +[![EbookFoundation/free-programming-books's Monthly Active Contributors graph](https://contributor-overtime-api.apiseven.com/contributors-svg?chart=contributorMonthlyActivity&repo=ebookfoundation/free-programming-books)](https://www.apiseven.com/en/contributor-graph?chart=contributorMonthlyActivity&repo=ebookfoundation/free-programming-books) + +
+ +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 sobre la rama con la que inició su 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) (también disponible [traducciones / otros idiomas](../README.md#translations)). diff --git a/docs/HOWTO.md b/docs/HOWTO.md index 45096d6bd..6641068ba 100644 --- a/docs/HOWTO.md +++ b/docs/HOWTO.md @@ -1,17 +1,34 @@ +# How-To at a glance + +
+ *[Read this in other languages](../README.md#translations)* -Welcome to Free-Programming-Books! We welcome new contributors; even those making their very first pull request on Github. If you're one of those, here are some resources that might help: +
-* [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) +**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 Requests](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-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://contributor-graph-api.apiseven.com/contributors-svg?repo=EbookFoundation/free-programming-books) community. +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. -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. +
+Details about that growth -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)) +[![EbookFoundation/free-programming-books's Contributor over time Graph](https://contributor-overtime-api.apiseven.com/contributors-svg?chart=contributorOverTime&repo=ebookfoundation/free-programming-books)](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) + +[![EbookFoundation/free-programming-books's Monthly Active Contributors graph](https://contributor-overtime-api.apiseven.com/contributors-svg?chart=contributorMonthlyActivity&repo=ebookfoundation/free-programming-books)](https://www.apiseven.com/en/contributor-graph?chart=contributorMonthlyActivity&repo=ebookfoundation/free-programming-books) + +
+ +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) also available)*.