Skip to content

Commit

Permalink
Squashed commit of the following:
Browse files Browse the repository at this point in the history
commit 8dc0bae
Merge: b0a28e6 1ebe024
Author: Nick Holden <nick.r.holden@gmail.com>
Date:   Tue Dec 21 12:39:01 2021 -0800

    Merge pull request github#2685 from Deletor/main

    improving grammar

commit 1ebe024
Merge: 503728d b0a28e6
Author: Nick Holden <nick.r.holden@gmail.com>
Date:   Tue Dec 21 12:36:11 2021 -0800

    Merge branch 'main' into main

commit b0a28e6
Merge: 82d7f23 8c65189
Author: Nick Holden <nick.r.holden@gmail.com>
Date:   Tue Dec 21 12:35:43 2021 -0800

    Merge pull request github#2684 from github/dependabot-bundler-html-proofer-3.19.3

    Bump html-proofer from 3.19.2 to 3.19.3

commit 8c65189
Merge: 294623e 82d7f23
Author: Nick Holden <nick.r.holden@gmail.com>
Date:   Tue Dec 21 12:32:50 2021 -0800

    Merge branch 'main' into dependabot-bundler-html-proofer-3.19.3

commit 82d7f23
Merge: b894313 04266ab
Author: Nick Holden <nick.r.holden@gmail.com>
Date:   Tue Dec 21 12:31:01 2021 -0800

    Merge pull request github#2667 from Morion-Self/fix-spelling

    Fix spelling mistake in 'How to contribute'

commit 04266ab
Merge: c2aca18 b894313
Author: Nick Holden <nick.r.holden@gmail.com>
Date:   Tue Dec 21 12:28:15 2021 -0800

    Merge branch 'main' into fix-spelling

commit b894313
Merge: 496f2d9 cb77345
Author: Nick Holden <nick.r.holden@gmail.com>
Date:   Tue Dec 21 12:24:29 2021 -0800

    Merge pull request github#2659 from kant/patch-11

    Typo fixed (paragraph 50)

commit cb77345
Merge: ced4d34 496f2d9
Author: Nick Holden <nick.r.holden@gmail.com>
Date:   Tue Dec 21 12:21:39 2021 -0800

    Merge branch 'main' into patch-11

commit 496f2d9
Merge: 584b02d 86ab8f5
Author: Nick Holden <nick.r.holden@gmail.com>
Date:   Tue Dec 21 12:15:14 2021 -0800

    Merge pull request github#2658 from kant/patch-10

    Syntax and typos fixed

commit 503728d
Merge: 49f992f 584b02d
Author: Deletor <annco88@gmail.com>
Date:   Tue Dec 21 21:14:27 2021 +0100

    Merge branch 'github:main' into main

commit 86ab8f5
Merge: 555ef31 584b02d
Author: Nick Holden <nick.r.holden@gmail.com>
Date:   Tue Dec 21 12:12:41 2021 -0800

    Merge branch 'main' into patch-10

commit 584b02d
Merge: 6520bc0 5e46900
Author: Nick Holden <nick.r.holden@gmail.com>
Date:   Tue Dec 21 12:12:02 2021 -0800

    Merge pull request github#2656 from parroty/fix-jp-typo

    Fix typo in the starting-a-project.md (Japanese translation)

commit 49f992f
Merge: 7d78923 6520bc0
Author: Nick Holden <nick.r.holden@gmail.com>
Date:   Tue Dec 21 12:11:32 2021 -0800

    Merge branch 'main' into main

commit 294623e
Merge: 6ea27cc 6520bc0
Author: Nick Holden <nick.r.holden@gmail.com>
Date:   Tue Dec 21 12:11:20 2021 -0800

    Merge branch 'main' into dependabot-bundler-html-proofer-3.19.3

commit c2aca18
Merge: d215a2e 6520bc0
Author: Nick Holden <nick.r.holden@gmail.com>
Date:   Tue Dec 21 12:09:22 2021 -0800

    Merge branch 'main' into fix-spelling

commit ced4d34
Merge: 96fb752 6520bc0
Author: Nick Holden <nick.r.holden@gmail.com>
Date:   Tue Dec 21 12:07:37 2021 -0800

    Merge branch 'main' into patch-11

commit 555ef31
Merge: f57d6dc 6520bc0
Author: Nick Holden <nick.r.holden@gmail.com>
Date:   Tue Dec 21 12:07:24 2021 -0800

    Merge branch 'main' into patch-10

commit 5e46900
Merge: ec017a7 6520bc0
Author: Nick Holden <nick.r.holden@gmail.com>
Date:   Tue Dec 21 12:06:42 2021 -0800

    Merge branch 'main' into fix-jp-typo

commit 6520bc0
Merge: 49b7a05 89a0925
Author: Nick Holden <nick.r.holden@gmail.com>
Date:   Tue Dec 21 12:06:28 2021 -0800

    Merge pull request github#2687 from github/remove-ebooks

    Remove script for generating ebooks

commit 89a0925
Author: Nick Holden <nick.r.holden@gmail.com>
Date:   Mon Dec 20 15:35:25 2021 -0800

    Remove script for generating ebooks

commit 7d78923
Author: Deletor <annco88@gmail.com>
Date:   Mon Dec 20 18:31:01 2021 +0100

    improving grammar

commit d215a2e
Author: Marat Talipov <Morion-Self@users.noreply.github.com>
Date:   Sat Dec 11 18:52:09 2021 +0500

    Fix spelling mistakes in 'How to contribute'

commit 96fb752
Author: Darío Hereñú <magallania@gmail.com>
Date:   Thu Dec 9 15:29:43 2021 -0300

    Typo fixed (paragraph 50)

commit f57d6dc
Author: Darío Hereñú <magallania@gmail.com>
Date:   Thu Dec 9 15:24:20 2021 -0300

    Syntax issue (paragraph 74)

    - Typos fixed (paragraph 44, 106, 110, 186, 188, 214, 235)

commit ec017a7
Author: parroty <parroty00@gmail.com>
Date:   Tue Dec 7 21:41:26 2021 +0900

    Fix typo
  • Loading branch information
tonymreyes537 committed Dec 22, 2021
1 parent 6ea27cc commit 11810f6
Show file tree
Hide file tree
Showing 7 changed files with 16 additions and 219 deletions.
2 changes: 1 addition & 1 deletion _articles/es/metrics.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ Si tu proyecto est&aacute; hosteado en GitHub, [puedes ver](https://help.github.

* **Contenido popular:** Te informa sobre las partes del proyecto que la gente m&aacute;s visita.

[GitHub stars](https://help.github.com/articles/about-stars/) puede brindarte una l&iacute;nea base para medir popularidad. No necesariamente tiene que ver con uso o cantidad de decargas, si no m&aacute;s bien según la cantidad de notoriedad de tu proyecto.
[GitHub stars](https://help.github.com/articles/about-stars/) puede brindarte una l&iacute;nea base para medir popularidad. No necesariamente tiene que ver con uso o cantidad de descargas, si no m&aacute;s bien según la cantidad de notoriedad de tu proyecto.

Quiz&aacute;s tambi&eacute;n quieras [rastrear la forma que te descubren desde lugares espec&iacute;ficos](https://opensource.com/business/16/6/pirate-metrics): por ejemplo, Google PageRank, tr&aacute;fico que hace referencia a tu p&aacute;gina web del proyecto, o referencias desde otros proyectos.

Expand Down
16 changes: 8 additions & 8 deletions _articles/es/starting-a-project.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ Realicemos una comparaci&oacute;n: un proceso de c&oacute;digo cerrado ser&iacut

* **Colaboraci&oacute;n:** Los proyectos de c&oacute;digo abierto pueden aceptar cambios efectuados por cualquier persona alrededor del mundo. [Exercism](https://github.com/exercism/), por ejemplo, una plataforma para ejercicios de programaci&oacute;n con m&aacute;s de 350 colaboradores.

* **Adopci&oacute;n y remezcla:** Los proyectos de c&oacute;digo abierto puedne ser usados por cualquiera para casi cualquier pr&oacute;p&oacute;sito. Las personas pueden usarlos hasta para construir otras cosas. [WordPress](https://github.com/WordPress), por ejemplo, comenzaron como un "fork" de un proyecto existente llamado [b2](https://github.com/WordPress/book/blob/HEAD/Content/Part%201/2-b2-cafelog.md).
* **Adopci&oacute;n y remezcla:** Los proyectos de c&oacute;digo abierto pueden ser usados por cualquiera para casi cualquier pr&oacute;p&oacute;sito. Las personas pueden usarlos hasta para construir otras cosas. [WordPress](https://github.com/WordPress), por ejemplo, comenzaron como un "fork" de un proyecto existente llamado [b2](https://github.com/WordPress/book/blob/HEAD/Content/Part%201/2-b2-cafelog.md).

* **Transparencia:** Cualquiera puede inspeccionar un proyecto de este tipo, ya sea para encontrar errores como inconsistencias. La transparencia es de importancia para gobiernos como el de [Bulgaria](https://medium.com/@bozhobg/bulgaria-got-a-law-requiring-open-source-98bf626cf70a) o [United States](https://sourcecode.cio.gov/), para industrias reguladas como la bancaria o la del cuidado de la salud, y para la seguridad del software como [Let's Encrypt](https://github.com/letsencrypt).

Expand Down Expand Up @@ -71,7 +71,7 @@ Si no estás convencido todav&iacute;a, toma un momento para pensar acerca de cu

Los objetivos pueden ayudarte a detectar puntos en los que continuar trabajando, a qu&eacute; decirle que no, y a d&oacute;nde recurrir por ayuda. Comienza pregunt&aacute;ndote, _&iquest;Por qu&eacute; estoy haciendo "c&oacute;digo abierto" a mi proyecto?_

No hay nunca una respuesta correcta a la &eacute;sta pregunta. Puedes tener m&uacute;ltiples objetivos para un solo proyecto, o diferentes proyectos con diferentes objetivos.
No hay nunca una respuesta correcta a esta pregunta. Puedes tener m&uacute;ltiples objetivos para un solo proyecto, o diferentes proyectos con diferentes objetivos.

Si tu &uacute;nico objetivo es mostrar al mundo tu trabajo, quiz&aacute;s no necesites ni quieras contribuci&oacute;n, y quiz&aacute;s digas eso en el README. Por otra parte, si quieres ayuda, invertir&aacute;s tiempo en clarificar la documentaci&oacute;n y en hacer sentir a los reci&eacute;n llegados bienvenidos.

Expand Down Expand Up @@ -103,11 +103,11 @@ Si necesitas un presupuesto dedicado o personal para la promoci&oacute;n, operac

Si tu meta es aprender c&oacute;mo contribuir con otros o entender c&oacute;mo funciona el "c&oacute;digo abierto", considera contribuir en proyectos existentes. Comienza con proyectos que ya has estado usando y que te gustan. Contribuir a un proyecto puede ser tan simple como arreglar "typos" o actualizar documentaci&oacute;n.

Si no sab&eacute;s como comenzar a contribuir, mira esto [Gu&iacute;a sobre c&oacute;mo contribuir](../how-to-contribute/).
Si no sab&eacute;s como comenzar a contribuir, mira esta [Gu&iacute;a sobre c&oacute;mo contribuir](../how-to-contribute/).

## Lanzando tu propio proyecto de C&oacute;digo Abierto

No hay momento prefecto para abrir el c&oacute;digo de tu trabajo. Puedes abrir el de una idea, el de un trabajo en progreso, o despu&eacute;s de varios a&ntilde;os de ser un proyecto cerrado.
No hay momento perfecto para abrir el c&oacute;digo de tu trabajo. Puedes abrir el de una idea, el de un trabajo en progreso, o despu&eacute;s de varios a&ntilde;os de ser un proyecto cerrado.

Generalmente, puedes abrir el c&oacute;digo de tu proyecto cuando te sientas c&oacute;modo de que otras personas vean y te aconsejen sobre tu trabajo.

Expand Down Expand Up @@ -183,9 +183,9 @@ Por ejemplo, [Active Admin](https://github.com/activeadmin/activeadmin/) comienz

> Primero, muchas gracias por considerar contribuir a Active Admin. Son personas como ustedes las que la hacen una gran herramienta.
En las primeras etapas del proyecto, tu archivo CONTRIBUITNG puede ser simple. Siempre debes explicar c&oacute;mo reportar bugs o issues, y cualquier requerimiento t&eacute;cnico (como tests) para hacer una contribuci&oacute;n.
En las primeras etapas del proyecto, tu archivo CONTRIBUTING puede ser simple. Siempre debes explicar c&oacute;mo reportar bugs o issues, y cualquier requerimiento t&eacute;cnico (como tests) para hacer una contribuci&oacute;n.

Con el tiempo, quiz&aacute;s debas agregar otras "preguntas frecuentes" a tu archivo. Escribir &eacute;sta informaci&oacute;n significa que menos personas te preguntar&aacute;n nuevamente la misma pregunta.
Con el tiempo, quiz&aacute;s debas agregar otras "preguntas frecuentes" a tu archivo. Escribir esta informaci&oacute;n significa que menos personas te preguntar&aacute;n nuevamente la misma pregunta.

Para m&aacute;s informaci&oacute;n sobre este tema, puedes acceder a @nayafia's [contributing guide template](https://github.com/nayafia/contributing-template/blob/HEAD/CONTRIBUTING-template.md) o @mozilla's ["How to Build a CONTRIBUTING.md"](https://mozillascience.github.io/working-open-workshop/contributing/).

Expand All @@ -211,7 +211,7 @@ Adem&aacute;s de comunicar _c&oacute;mo_ esperas que se comporten los participan

Como muchas licencias de c&oacute;digo abierto, existen est&aacute;ndares emergentes para c&oacute;digos de conducta para que no debas escribir uno propio. El [Contributor Covenant](https://www.contributor-covenant.org/) es un c&oacute;digo de conducta usado por [m&aacute;s de 40000 proyectos de c&oacute;digo abierto](https://www.contributor-covenant.org/adopters), incluyendo Kubernetes, Rails, and Swift. Debes estar preparado para redefinir el tuyo cuando sea necesario.

Copia el texto directamente en el archivo CODE_OF_CONDUCT dentro de tu repositorio, en el directorio ra&iacute;z, y vinculalo desde tu README.
Copia el texto directamente en el archivo CODE_OF_CONDUCT dentro de tu repositorio, en el directorio ra&iacute;z, y vincúlalo desde tu README.

## Dando un nombre y una marca a tu proyecto

Expand All @@ -232,7 +232,7 @@ Considera claridad por sobre todo. Los chismes son divertidos,pero recuerda que

Busca proyectos con el mismo nombre, o similar, especialmente si compartes el mismo ecosistema o idioma. Si tu nombre coincide con alg&uacute;n otro proyecto popular, puede confundir a las personas.

Si quieres una p&aacute;gina web, manejo de Twitter, u otros &iacute;tems que representen tu proyecto, asegurate de que puedas asignar el nombre que quieras. En lo posible, [reserva tu nombre ahora](https://instantdomainsearch.com/) para estar tranquilo, aunque a&uacute;n no lo vayas a usar.
Si quieres una p&aacute;gina web, manejo de Twitter, u otros &iacute;tems que representen tu proyecto, asegúrate de que puedas asignar el nombre que quieras. En lo posible, [reserva tu nombre ahora](https://instantdomainsearch.com/) para estar tranquilo, aunque a&uacute;n no lo vayas a usar.

Tu nombre no debe infringir ninguna marca (trademark), de ser as&iacute; la compa&ntilde;&iacute;a puede pedirte que des de baja a tu proyecto, o puede tomar acciones legales en tu contra. No vale el riesgo.

Expand Down
2 changes: 1 addition & 1 deletion _articles/ja/starting-a-project.md
Original file line number Diff line number Diff line change
Expand Up @@ -249,7 +249,7 @@ README に CONTRIBUTING ファイルへのリンクをすることで、より

暖かく、排他的でない言葉遣い(一人の人を指すときであっても「彼ら」を使う、といったような)をすることで、あなたのプロジェクトで新しいコントリビューターが歓迎されていると感じてもらうことに繋がります。シンプルな言葉遣いをすることにこだわりましょう。あなたのプロジェクトを見る人の多くは英語のネイティブスピーカーではないかもしれません。

あなたがどう文書を書くかに加えて、あなたのコーディングスタイルもプロジェクトのブランドの一分になるかもしれません[Angular](https://github.com/johnpapa/angular-styleguide)[jQuery](https://contribute.jquery.org/style-guide/js/) の2つは厳密なコーディングスタイルとガイドラインを持つプロジェクトの例です。
あなたがどう文書を書くかに加えて、あなたのコーディングスタイルもプロジェクトのブランドの一部になるかもしれません[Angular](https://github.com/johnpapa/angular-styleguide)[jQuery](https://contribute.jquery.org/style-guide/js/) の2つは厳密なコーディングスタイルとガイドラインを持つプロジェクトの例です。

かならずしもプロジェクトを始める際にスタイルガイドを書く必要はありませんし、とにかく異なるコーディングスタイルを盛り込むのが楽しいと思うかもしれません。しかし、あなたの文書やコーディングスタイルが異なるタイプの人々を惹きつけることもあれば落胆させることもあるということを予期しておくべきです。プロジェクトの最初期はあなたが望む先例を作る良い機会です。

Expand Down
4 changes: 2 additions & 2 deletions _articles/pl/best-practices.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ Zapisywanie zasad może być denerwujące. Czasami możesz mieć wrażenie, że

Napisane i rzetelnie egzekwowane dobre zasady, jednak upoważniają opiekunów. Zapobiegają wciągnięciu cię w robienie rzeczy, których nie chcesz robić.

Większość ludzi, którzy natkną się na twój projekt, nie wie nic o tobie ani twoich okolicznościach. Mogą założyć, że zarabiasz za pracę nad tym, zwłaszcza jeśli jest to coś, z czego regularnie korzystają i na którym polegają. Może w pewnym momencie poświęcisz dużo czasu na swój projekt, ale teraz jesteś zajęty nową pracą lub członkiem rodziny.
Większość ludzi, którzy natkną się na twój projekt, nie wie nic o tobie ani twoich okolicznościach. Mogą założyć, że zarabiasz za pracę nad tym, zwłaszcza jeśli jest to coś, z czego regularnie korzystają i na czym polegają. Może w pewnym momencie poświęcałeś dużo czasu na swój projekt, ale teraz jesteś zajęty nową pracą lub członkiem rodziny.

Wszystko to jest w porządku! Upewnij się tylko, że inni wiedzą o tym.

Expand Down Expand Up @@ -161,7 +161,7 @@ Jeśli widzisz, że ktoś jest entuzjastycznie nastawiony do twojego projektu, a

## Wykorzystaj swoją społeczność

Nie musisz robić wszystkiego sam. Społeczność twojego projektu istnieje bez powodu! Nawet jeśli nie masz jeszcze aktywnej społeczności współautorów, jeśli masz wielu użytkowników, włącz ich do pracy.
Nie musisz robić wszystkiego sam. Społeczność twojego projektu nie istnieje bez powodu! Nawet jeśli nie masz jeszcze aktywnej społeczności współautorów, jeśli masz wielu użytkowników, włącz ich do pracy.

### Udostępnij obciążenie pracą

Expand Down
8 changes: 4 additions & 4 deletions _articles/ru/how-to-contribute.md
Original file line number Diff line number Diff line change
Expand Up @@ -478,14 +478,14 @@ related:
* Сделать незначительное исправление (например, исправить опечатку, неработающую ссылку или очевидную ошибку)
* Начать работать над тем, о чём уже было договорено или что обсуждалось в ишью

Пул-реквест не обязательно должен представлять законченную работу. Обычно лучше пул-реквест на раннем этапе, чтобы люди могли наблюдать за вашим прогрессом или оставлять отзывы о нем. Только в названии таком пул-реквесте укажите "WIP" (от англ. Work in Progress — в процессе выполнения). Всегда позже можно отправить дополнительные коммиты.
Пул-реквест не обязательно должен представлять законченную работу. Обычно лучше открывать пул-реквест на раннем этапе, чтобы люди могли наблюдать за вашим прогрессом или оставлять отзывы о нем. Только в названии таком пул-реквесте укажите "WIP" (от англ. Work in Progress — в процессе выполнения). Всегда позже можно отправить дополнительные коммиты.

Если проект находится на GitHub, выполните следующие шаги, чтобы создать пул-реквест:

* **[Форкните репозиторий](https://guides.github.com/activities/forking/)** и склонируйте его к себе локально. Затем в этом локальном репозитории добавьте оригинальный (upstream) репозиторий. Почаще загружайте изменения из исходного репозиторий, чтобы ваш локальный репозиторий оставался в актуальном состоянии, — это снизит появление конфликтов при создании пул-реквеста. (См. более подробные инструкции [здесь](https://help.github.com/articles/syncing-a-fork/).)
* **[Создайте ветку](https://guides.github.com/introduction/flow/)** для ваших правок.
* **Ссылайтесь на любые относящиеся к делу ишью** или подтверждающую документацию в своем PR (например, «Closes #37»).
* **Добавьте скриншоты до и после**, если ваши изменения включают затрагивает файлы HTML/CSS. Перетащите изображения в текстовую область пул-реквеста.
* **Добавьте скриншоты до и после**, если ваши изменения затрагивают файлы HTML/CSS. Перетащите изображения в текстовую область пул-реквеста.
* **Протестируйте свои изменения!** Например, если есть, запустите тесты, и при необходимости напишите новые. Даже если нет тестов, проверьте сами, что после ваших изменений всё работает, как и раньше.
* **Соблюдайте стиль написания кода проекта** в меру своих возможностей. Это может быть использование отступов, точек с запятой или комментариев иначе, чем вы привыкли, но мейнтейнерам это упросит слияние вашего пул-реквеста, а другим — облегчит понимание и поддержку в будущем.

Expand All @@ -505,7 +505,7 @@ related:

**Не** обращайтесь напрямую к этому человеку; помните, что публичное общение жизненно важно для опенсорс-проектов.

Если после вежливого напоминания, так и никто не ответил, есть вероятность, что никто и никогда не ответит. Это не самое приятное ощущение, но пусть оно вас не расстраивает. Такое с каждым случалось! Есть множество возможных причин, по которым вам не ответили, в том числе личные обстоятельства, на которые вы можете повлиять. Попробуйте найти другой проект или способ участия. Во всяком случае, нет больше смысла вкладываться в такие проекты, по крайней мере до того момента, когда объявляться другие члены сообщества.
Если после вежливого напоминания так и никто не ответил, есть вероятность, что никто и никогда не ответит. Это не самое приятное ощущение, но пусть оно вас не расстраивает. Такое с каждым случалось! Есть множество возможных причин, по которым вам не ответили, в том числе личные обстоятельства, на которые вы можете повлиять. Попробуйте найти другой проект или способ участия. Во всяком случае, нет больше смысла вкладываться в такие проекты, по крайней мере до того момента, когда объявятся другие члены сообщества.

### 🚧 У вас могут запросить внести изменения.

Expand All @@ -517,7 +517,7 @@ related:

### 👎 Ваш вклад не принят.

В итоге ваш вклад может быть принят или нет. Надеюсь, вы не потратили слишком много усилий на него. Если для вас не было понятно, почему он не был принят, разумно попросить мейнтейнера дать пояснения. В конечном итоге, однако, вам нужно стоит понять и смирится с их решением. Не спорьте и не злитесь по этому поводу. В случае чего вы всегда можете форкнуть репозиторий, чтобы работать над своей собственной версией продукта!
В итоге ваш вклад может быть принят или нет. Надеюсь, вы не потратили слишком много усилий на него. Если для вас не было понятно, почему он не был принят, разумно попросить мейнтейнера дать пояснения. В конечном итоге, однако, вам стоит понять и смирится с их решением. Не спорьте и не злитесь по этому поводу. В случае чего вы всегда можете форкнуть репозиторий, чтобы работать над своей собственной версией продукта!

### 🎉 Ваш вклад принят.

Expand Down
Loading

0 comments on commit 11810f6

Please sign in to comment.