diff --git a/docs/src/content/docs/ru/guides/checkout-answer.md b/docs/src/content/docs/ru/guides/checkout-answer.md index b320cd6..375cf87 100644 --- a/docs/src/content/docs/ru/guides/checkout-answer.md +++ b/docs/src/content/docs/ru/guides/checkout-answer.md @@ -1,21 +1,21 @@ --- -title: Изучай чужие решения +title: Изучайте чужие решения description: Руководство по просмотру чужого ответа. sidebar: order: 3 --- -Все ответы на испытания Angular представлены в виде Pull Request (PR). Чтобы их просмотреть и изучить, перейди на страницу **Files Changes** на GitHub. Однако, если ты не знаком с интерфейсом, процесс может быть не очевидным. Иногда просмотреть решение в твоей любимой IDE может быть удобнее. +Все ответы на испытания Angular представлены в виде Pull Request (PR). Чтобы их просмотреть и изучить, нужно перейти на страницу **Files Changes** на GitHub. Однако, если вы не знакомы с интерфейсом, процесс может быть не очевидным. Иногда посмотреть на решение в вашей любимой IDE может быть удобнее. -Это руководство поможет тебе с этим. +Это руководство поможет вам с этим. ## Проверьте чужой PR локально -### Синхронизируй свой репозиторий +### Синхронизируйте свой репозиторий -В начале тебе нужно синхронизировать твою копию репозитория, чтобы убедиться, что она находится в актуальном состоянии. +В начале вам нужно синхронизировать вашу копию репозитория, чтобы убедиться, что она находится в актуальном состоянии. -Это можно сделать, нажав кнопку **Sync fork** на главной странице репозитория. +Это можно сделать, нажав на кнопку **Sync fork** на главной странице репозитория. ![Sync project header](../../../../assets/fork-sync.png) @@ -23,26 +23,26 @@ sidebar: ![Sync project update modal](../../../../assets/sync-fork-update.png) -### Перейди на PR +### Перейдите к PR -Перейди к PR, который ты хочешь изучить локально, и узнай его ID. Ты найдешь его в заголовке PR (как показано ниже). +Перейдите к PR, который вы хотите изучить локально, и узнайте его ID. Вы найдете его в заголовке PR (как показано ниже). ![PR header](../../../../assets/PR-header.png) -Далее открой терминал в каталоге проекта и выполни следующую команду: +Далее откройте терминал в каталоге проекта и выполните следующую команду: ```bash gh pr checkout ``` -Если ты не помнишь команду, нажми на кнопку "Code" в правой части заголовка, и ты сможешь легко скопировать/вставить команду. +Если вы не помните команду, нажмите на кнопку "Code" в правой части заголовка, и вы сможете легко скопировать/вставить команду. ![PR code modal](../../../../assets/PR-code-btn-modal.png) :::note[Примечание] -Если команда не сработала или не выполнилась, Github CLI подскажет что делать. +Если команда не сработала, Github CLI подскажет что делать. ::: -🔥Теперь ты можешь изучать решение локально и запускать его для тестирования.🔥 +🔥Теперь вы можете изучить решение локально и запустить его для тестирования.🔥 diff --git a/docs/src/content/docs/ru/guides/contribute.md b/docs/src/content/docs/ru/guides/contribute.md index 26e5aa3..e485547 100644 --- a/docs/src/content/docs/ru/guides/contribute.md +++ b/docs/src/content/docs/ru/guides/contribute.md @@ -1,20 +1,20 @@ --- -title: Вноси свой вклад +title: Вносите свой вклад description: Описание как помочь проекту sidebar: order: 4 --- -Ты можешь помочь проекту многими способами: +Вы можете помочь проекту многими способами: -🔥 Создавай новые испытания, следуя инструкциям [тут](/guides/create-challenge). +🔥 Создавайте новые испытания, следуя инструкциям [тут](/guides/create-challenge). -🔥 Проходи испытания и отправляй свои решения. (руководство [тут](/guides/resolve-challenge)). +🔥 Проходите испытания и отправляйте свои решения на ревью. (руководство [тут](/guides/resolve-challenge)). -🔥 Проводи ревью чужих решений, давая конструктивные и дружелюбные комментарии. +🔥 Проводите ревью чужих решений, оставляя конструктивные и дружелюбные комментарии. -🔥 Исправляй опечатки и ошибки в документации. +🔥 Исправляйте опечатки и ошибки в документации. -🔥 Оставляй заявки, чтобы предложить идеи новых испытаний или чтобы сообщить об ошибках. +🔥 Оставляйте issues, чтобы предложить идеи новых испытаний или чтобы сообщить об ошибках. -🔥 Поддерживай проект [тут](https://github.com/sponsors/tomalaforge). +🔥 Поддерживайте проект [тут](https://github.com/sponsors/tomalaforge). diff --git a/docs/src/content/docs/ru/guides/create-challenge.md b/docs/src/content/docs/ru/guides/create-challenge.md index 7810973..7234e38 100644 --- a/docs/src/content/docs/ru/guides/create-challenge.md +++ b/docs/src/content/docs/ru/guides/create-challenge.md @@ -1,23 +1,23 @@ --- -title: Создай свое испытание +title: Создайте свое испытание description: Руководство по созданию испытания sidebar: order: 5 --- -У тебя есть идея, которой ты хочешь поделиться, интересная ошибка, с которой ты борешься в одном из своих приватных или побочных проектов, или трюк Angular, который ты обнаружил. Все эти возможности - хорошая отправная точка, чтобы создать задачу и поделиться ее решением с другими. +У вас есть идея, которой вы хотите поделиться, интересная ошибка, с которой вы боретесь в одном из своих проектов, или что-то необычное в Angular, что вы обнаружили. Всё это - хорошая отправная точка, чтобы создать испытание и поделиться её решением с другими. Но как начать создавать испытания? ## Шаблон создания испытания -Чтобы упростить этот процесс, я создал генератор Nx, который настроит все за тебя и поможет тебе быстрее начать. Проще всего его запустить в консоли Nx: перейди в раздел Nx Console > generate > @angular-challenges/cli - challenge +Чтобы упростить этот процесс, я создал генератор Nx, который настроит все за вас и поможет вам быстрее начать. Проще всего его запустить в консоли Nx: перейдите в раздел Nx Console > generate > @angular-challenges/cli - challenge ### Параметры #### обязательные параметры -- title: Название, которое ты хочешь дать испытанию. +- title: Название, которое вы хотите дать испытанию. :::note[Примечание] Название должно быть не больше 25 символов. ::: @@ -31,8 +31,8 @@ sidebar: #### не обязательные параметры -- directory: Если ты хочешь, чтобы приложение находилось в определенной папке внутри `apps`. -- addTest: Если хочешь добавить конфигурацию теста. +- directory: Если вы не хотите, чтобы приложение находилось в стандартной папке внутри `apps`. +- addTest: Если хотите добавить конфигурацию теста. ### Что будет создано @@ -44,11 +44,11 @@ sidebar: Все что осталось - создать испытание. 🚀 :::danger[Опасно] -Не забудь обновить документацию, чтобы описать свою задачу и дать инструкции. +Не забудьте обновить документацию, чтобы описать свою задачу и дать инструкции. ::: -Дальше действовать будешь ты!!! 💪 +Дальше действовать будете вы!!! 💪 ## Отправка решения -Через неделю или около того не забудь представить свое решение задачи. +Через неделю или около того не забудьте представить своё решение задачи. diff --git a/docs/src/content/docs/ru/guides/faq.md b/docs/src/content/docs/ru/guides/faq.md index ad12e0a..1e68687 100644 --- a/docs/src/content/docs/ru/guides/faq.md +++ b/docs/src/content/docs/ru/guides/faq.md @@ -8,10 +8,10 @@ sidebar:
Почему мое приложение не запускается, или почему я вижу ошибки в терминале при запуске `nx serve`? -Чаще всего эта проблема возникает из-за того, что фnode_modules устарели, и тебе нужно обновить их, выполнив команду `npm ci`. +Чаще всего эта проблема возникает из-за того, что node_modules устарели, и вам нужно обновить их, выполнив команду `npm ci`. -Если установка завершилась неудачно, ты можешь решить эту проблему, удалив папку node_modules с помощью команды `rm -rf node_modules` или `npx npkill` а затем снова выполнить `npm ci`. +Если установка завершилась неудачно, вы можете попробовать решить эту проблему, удалив папку node_modules с помощью команды `rm -rf node_modules` или `npx npkill` а затем снова выполнить `npm ci`. -Если проблема сохраняется, пожалуйста сообщи о ней [тут](https://github.com/tomalaforge/angular-challenges/issues/new). +Если проблема сохранится, пожалуйста сообщи о ней [тут](https://github.com/tomalaforge/angular-challenges/issues/new).
diff --git a/docs/src/content/docs/ru/guides/getting-started.md b/docs/src/content/docs/ru/guides/getting-started.md index 78e64e1..7145016 100644 --- a/docs/src/content/docs/ru/guides/getting-started.md +++ b/docs/src/content/docs/ru/guides/getting-started.md @@ -5,22 +5,22 @@ sidebar: order: 1 --- -Чтобы начать работу с испытаниями Angular, выполни следующие шаги: +Чтобы начать работу с испытаниями Angular, выполните следующие шаги: -## Создай аккаунт на Github +## Создайте аккаунт на Github -Если ты захочешь отправить решение, тебе потребуется аккаунт на GitHub. Кроме того, иметь учетную запись на GitHub всегда полезно. Тем более это бесплатно. +Если вы захотите отправить свое решение для испытания, вам потребуется аккаунт на GitHub. Кроме того, иметь учетную запись на GitHub всегда полезно. Тем более это бесплатно. -## Скопируй github проект +## Скопируйте github проект -Перейди в [Angular Challenges Repository](https://github.com/tomalaforge/angular-challenges) и нажми на кнопку Fork в вверху страницы. Это создаст копию этого репозитория на твоей GitHub странице. +Перейдите в [Angular Challenges Repository](https://github.com/tomalaforge/angular-challenges) и нажмите на кнопку Fork в вверху страницы. Это создаст копию репозитория на вашей GitHub странице. -## Клонируй репозиторий на свой компьютер +## Клонируйте репозиторий на свой компьютер -Выбери папку на своем компьютере и клонируй репозиторий. +Выберите папку на своем компьютере и клонируйте репозиторий. -Открой терминал, перейди в выбранный каталог, и набери команду: +Откройте терминал, перейдите в выбранный каталог, и наберите команду: ```bash git clone https://github.com/[YOUR_GITHUB_NAME]/angular-challenges.git @@ -28,30 +28,30 @@ git clone https://github.com/[YOUR_GITHUB_NAME]/angular-challenges.git :::note -Ты можешь найти URL адрес клонированного репозитория нажав на кнопку <> Code в твоем собственном экземпляре репозитория Angular Challenges. +Вы можете найти URL адрес клонированного репозитория нажав на кнопку <> Code в вашем собственном экземпляре репозитория Angular Challenges. ![Header of github workpspace](../../../../assets/header-github.png) ::: -## Открой проект в своей любимой среде разработки +## Откройте проект в вашей любимой среде разработки -Открой проект в любой IDE на твой выбор. +Откройте проект в любой IDE на ваш выбор. -## Установи все зависимости +## Установите все зависимости ```bash npm ci ``` -## Выбери задачу +## Выберите задачу -Твой проект сейчас поднят и запущен. Осталось только выбрать испытание 🚀 +Ваш проект сейчас поднят и запущен. Осталось только выбрать испытание 🚀 Каждое испытание состоит из: - Имя: описывает о чем испытание. -- Номер: номер создания. Этот номер не несет какого-то смысла, но служит для ссылки в секции Github Pull Request. +- Номер: порядковый номер создания. Этот номер не несет какого-то смысла, но служит для ссылки в секции Github Pull Request. - Бейдж: показывает уровень сложности. Полностью субъективно 😅 - 🟢 простое - 🟠 среднее diff --git a/docs/src/content/docs/ru/guides/rebase.md b/docs/src/content/docs/ru/guides/rebase.md index 12efc34..7ca098f 100644 --- a/docs/src/content/docs/ru/guides/rebase.md +++ b/docs/src/content/docs/ru/guides/rebase.md @@ -1,13 +1,13 @@ --- -title: Сделай rebase своей ветки +title: Сделайте rebase вашей ветки description: Руководство по rebase ветки на последние изменения sidebar: order: 6 --- -Иногда в проект могут вноситься изменения. Я стараюсь вносить изменения, которые ничего не сломают, но иногда это неизбежно. +Иногда в проект могут вноситься изменения. Я стараюсь вносить изменения, которые ничего не сломают, но иногда этого не избежать. -В большинстве случаев тебе не придется делать rebase твоего решения, но вот руководство, которое поможет тебе узнать, как это сделать. +В большинстве случаев вам не придется делать rebase вашего решения, но вот руководство, которое поможет вам понять, как это сделать. :::note[Примечание] Это руководство применимо к любому проекту с открытым исходным кодом. @@ -15,11 +15,11 @@ sidebar: ## Шаги rebase -### Синхронизируй свой репозиторий +### Синхронизируйте ваш репозиторий -Во-первых, тебе нужно синхронизировать твою копию, чтобы убедиться, что она содержит последние изменения. +Во-первых, вам нужно синхронизировать вашу копию, чтобы убедиться, что она содержит последние изменения. -Ты можешь сделать это, нажав на кнопку Sync fork на главной странице твоего репозитория. +Вы можете сделать это, нажав на кнопку Sync fork на главной странице вашего репозитория. ![Sync project header](../../../../assets/fork-sync.png) @@ -27,7 +27,7 @@ sidebar: ![Sync project update modal](../../../../assets/sync-fork-update.png) -### Открой терминал +### Откройте терминал Откройте любой терминал, будь то терминал в любимой IDE или отдельное приложение. @@ -39,17 +39,17 @@ sidebar: - git pull - git checkout [your branch] - git rebase main -- Реши конфликты +- Разрешите конфликты -На этом этапе rebase может остановиться, потому что в твоей локальной ветке есть конфликтующие файлы с основной веткой. Исправь это. После того как закончишь: +На этом этапе rebase может остановиться, потому что в вашей локальной ветке есть конфликтующие файлы с основной веткой. Исправьте это. После того как закончите: - git add . - git rebase --continue -Если в твоей ветке нет конфликтов, будет показано сообщение об успехе. +Если в вашей ветке нет конфликтов, будет показано сообщение об успехе. -### Отправь свою работу в удаленный репозиторий +### Отправьте свою работу в удаленный репозиторий -Наконец, отправь свою работу на GitHub: +Наконец, отправьте свою работу на GitHub: - git push -f diff --git a/docs/src/content/docs/ru/guides/resolve-challenge.md b/docs/src/content/docs/ru/guides/resolve-challenge.md index 0adb40b..09c5f4c 100644 --- a/docs/src/content/docs/ru/guides/resolve-challenge.md +++ b/docs/src/content/docs/ru/guides/resolve-challenge.md @@ -1,28 +1,28 @@ --- -title: Пройди испытание +title: Пройдите испытание description: Инструкция по прохождению испытания sidebar: order: 2 --- -В этом руководстве ты узнаешь, как пройти испытание и отправить решение в основной репозиторий Github. +В этом руководстве вы узнаете, как пройти испытание и отправить свое решение. ## Вступление -Этот репозиторий работает под управлением [Nx](https://nx.dev/getting-started/intro). Nx это монорепозиторий который позволяет тебе хранить несколько приложений в одном рабочем пространстве. -Каждое испытание - это отдельное приложение. Если ты откроешь каталог `apps`, то обнаружишь несколько директорий, каждая из которых относится к определенной задаче. Каждый каталог представляет собой полноценное приложение `Nx`. Чтобы запустить и начать работу с одним из них, открой терминал и выполни команду: +Этот репозиторий работает под управлением [Nx](https://nx.dev/getting-started/intro). Nx это монорепозиторий который позволяет вам хранить несколько приложений в одном рабочем пространстве. +Каждое испытание - это отдельное приложение. Если вы откроете каталог `apps`, то обнаружите несколько директорий, каждая из которых относится к определенной задаче. Каждый каталог представляет собой полноценное приложение `Nx`. Чтобы запустить и начать работу с одним из них, откройте терминал и выполните команду: ```bash npx nx serve <ИМЯ_ПРИЛОЖЕНИЯ> ``` :::note[Примечание] -Если ты не уверен в названии испытания `ИМЯ_ПРИЛОЖЕНИЯ`, открой файл README.md. Там написана команда `serve` со ссылкой на документацию по испытанию. +Если вы не уверены в названии испытания `ИМЯ_ПРИЛОЖЕНИЯ`, откройте файл README.md. Там написана команда `serve` со ссылкой на документацию по испытанию. ::: :::note[Примечание] -Если `nx` установлен глобально на твоем компьютере, ты можешь опустить `npx`. -Чтобы установить `nx` глобально, выполни +Если `nx` установлен глобально на вашем компьютере, вы можешь опустить команду `npx`. +Чтобы установить `nx` глобально, выполните ```bash npm i -g nx @@ -30,64 +30,64 @@ npm i -g nx ::: -## Создай Git Ветку +## Создайте Git Ветку -Прежде чем приступить к реализации решения испытания, создай ветку git для фиксации своей работы. +Прежде чем приступить к реализации вашего решения испытания, создайте ветку git для фиксации своей работы. ```bash git checkout -b ``` -## Пройди испытание +## Пройдите испытание -Следуй инструкция чтобы пройти испытание. +Изучите инструкции чтобы пройти испытание. -## Сделай коммит и отправь код в репозиторий +## Сделайте коммит и отправьте код в репозиторий Последний шаг это создание коммита, который следовал бы правилам из [Соглашения о коммитах](https://www.conventionalcommits.org/ru/v1.0.0/). -Наконец, отправь свою работу в удаленный репозиторий с помощью следующей команды: +Наконец, отправьте свою работу в удаленный репозиторий с помощью следующей команды: ```bash git push --set-upstream origin ``` :::tip[Не запоминай команду] -Тебе не нужно запоминать команду в точности. Нужно просто запомнить `git push`, и если ты впервые пушишь эту ветку, `git` подскажет тебе полную команду. +Вам не нужно запоминать команду в точности. Нужно просто запомнить `git push`, и если вы впервые загружаешь эту ветку в репозиторий, `git` подскажет вам полную команду. ::: -## Отправь свое решение в основной репозиторий +## Отправьте свое решение в основной репозиторий -Теперь вся твоя работа находится в твоем экземпляре репозитория Angular Challenges. +Теперь все ваше решение находится в вашем экземпляре репозитория Angular Challenges. -Следующий шаг - перейти на главную страницу [Angular Challenges](https://github.com/tomalaforge/angular-challenges) и создать новый запрос на слитие (Pull Request). +Следующий шаг - перейдите на главную страницу [Angular Challenges](https://github.com/tomalaforge/angular-challenges) и создайте новый запрос на слитие (Pull Request). -Github должен показать уведомление, чтобы помочь тебе создать pull request. +Github должен показать уведомление, чтобы помочь вам создать pull request. -Если этого не случилось, то ты либо неправильно выполнил один из предыдущих шагов, либо можешь перейти на вкладку Pull Request и нажать кнопку New pull request. +Если этого не случилось, то вы либо неправильно выполнили один из предыдущих шагов, либо вам нужно перейти на вкладку Pull Request и нажать кнопку New pull request. -После того как выберешь две ветки для сравнения, ты попадешь на следующую страницу: +После того как вы выберете две ветки для сравнения, вы попадете на следующую страницу: ![New pull request screen](../../../../assets/new-pull-request.png) -В заголовке напиши Answer:, затем номер твоего задания. После этого можешь добавить все, что пожелаешь. +В заголовке напишите Answer:, затем номер вашего испытания. После этого можете добавить все, что пожелаете. :::danger[Опасно] -Это очень важно. Это позволит другим узнать, какое испытание ты пытаешься решить. +Порядковый номер очень важен. Он позволит другим узнать, какое испытание вы пытаетесь решить. ::: -В разделе описания ты можешь добавить вопросы, проблемы, с которыми столкнулся, или все остальное, чем захочешь поделиться. Если написать нечего, можешь оставить этот раздел пустым. +В разделе описания вы можете добавить вопросы, проблемы, с которыми столкнулись, или все остальное, чем захотите поделиться. Если нечего написать, можете оставить этот раздел пустым. -Теперь можешь нажать на Create pull request. +Теперь вы можете нажать на кнопку Create pull request. -Я прочитаю и прокомментирую когда у меня будет свободное время. +Я прочитаю и проведу ревью вашего решения когда у меня будет свободное время. -

Не переживай если я не проревьювил твое решение сразу же. Я делаю это бесплатно в свое свободное время. Если ты хочешь меня поддержать, ты можешь это сделать с помощью поддержать на github. Это покажет, что моя работа полезна для вас или вашей команды.

+

Не переживайте если я не прокомментировал ваше решение сразу же. Я делаю это бесплатно в свое свободное время. Если вы хотите меня поддержать, вы можете это сделать с помощью поддержать на github. Это покажет, что моя работа полезна для вас или вашей команды.

:::note[Примечание] Все желающие могут оставлять комментарии и читать другие PR. ::: :::tip[OSS чемпион] -🔥 После того как ты пройдешь это руководство, ты готов внести свой вклад в любой другой публичный репозиторий Github и отправить PR. Это настолько просто.🔥 +🔥 После того как вы пройдете это руководство, вы сможете внести свой вклад в любой другой публичный репозиторий на Github. Да, это настолько просто.🔥 :::