diff --git a/docs/src/content/docs/ru/guides/getting-started.md b/docs/src/content/docs/ru/guides/getting-started.md new file mode 100644 index 0000000..78e64e1 --- /dev/null +++ b/docs/src/content/docs/ru/guides/getting-started.md @@ -0,0 +1,58 @@ +--- +title: Первые шаги +description: Руководство о том, как начать работу с испытаниями Angular. +sidebar: + order: 1 +--- + +Чтобы начать работу с испытаниями Angular, выполни следующие шаги: + +## Создай аккаунт на Github + +Если ты захочешь отправить решение, тебе потребуется аккаунт на GitHub. Кроме того, иметь учетную запись на GitHub всегда полезно. Тем более это бесплатно. + +## Скопируй github проект + +Перейди в [Angular Challenges Repository](https://github.com/tomalaforge/angular-challenges) и нажми на кнопку Fork в вверху страницы. Это создаст копию этого репозитория на твоей GitHub странице. + +## Клонируй репозиторий на свой компьютер + +Выбери папку на своем компьютере и клонируй репозиторий. + +Открой терминал, перейди в выбранный каталог, и набери команду: + +```bash +git clone https://github.com/[YOUR_GITHUB_NAME]/angular-challenges.git +``` + +:::note + +Ты можешь найти URL адрес клонированного репозитория нажав на кнопку <> Code в твоем собственном экземпляре репозитория Angular Challenges. + +![Header of github workpspace](../../../../assets/header-github.png) + +::: + +## Открой проект в своей любимой среде разработки + +Открой проект в любой IDE на твой выбор. + +## Установи все зависимости + +```bash +npm ci +``` + +## Выбери задачу + +Твой проект сейчас поднят и запущен. Осталось только выбрать испытание 🚀 + +Каждое испытание состоит из: + +- Имя: описывает о чем испытание. +- Номер: номер создания. Этот номер не несет какого-то смысла, но служит для ссылки в секции Github Pull Request. +- Бейдж: показывает уровень сложности. Полностью субъективно 😅 + - 🟢 простое + - 🟠 среднее + - 🔴 сложное diff --git a/docs/src/content/docs/ru/guides/resolve-challenge.md b/docs/src/content/docs/ru/guides/resolve-challenge.md new file mode 100644 index 0000000..0adb40b --- /dev/null +++ b/docs/src/content/docs/ru/guides/resolve-challenge.md @@ -0,0 +1,93 @@ +--- +title: Пройди испытание +description: Инструкция по прохождению испытания +sidebar: + order: 2 +--- + +В этом руководстве ты узнаешь, как пройти испытание и отправить решение в основной репозиторий Github. + +## Вступление + +Этот репозиторий работает под управлением [Nx](https://nx.dev/getting-started/intro). Nx это монорепозиторий который позволяет тебе хранить несколько приложений в одном рабочем пространстве. +Каждое испытание - это отдельное приложение. Если ты откроешь каталог `apps`, то обнаружишь несколько директорий, каждая из которых относится к определенной задаче. Каждый каталог представляет собой полноценное приложение `Nx`. Чтобы запустить и начать работу с одним из них, открой терминал и выполни команду: + +```bash +npx nx serve <ИМЯ_ПРИЛОЖЕНИЯ> +``` + +:::note[Примечание] +Если ты не уверен в названии испытания `ИМЯ_ПРИЛОЖЕНИЯ`, открой файл README.md. Там написана команда `serve` со ссылкой на документацию по испытанию. +::: + +:::note[Примечание] +Если `nx` установлен глобально на твоем компьютере, ты можешь опустить `npx`. +Чтобы установить `nx` глобально, выполни + +```bash +npm i -g nx +``` + +::: + +## Создай Git Ветку + +Прежде чем приступить к реализации решения испытания, создай ветку git для фиксации своей работы. + +```bash +git checkout -b +``` + +## Пройди испытание + +Следуй инструкция чтобы пройти испытание. + +## Сделай коммит и отправь код в репозиторий + +Последний шаг это создание коммита, который следовал бы правилам из [Соглашения о коммитах](https://www.conventionalcommits.org/ru/v1.0.0/). + +Наконец, отправь свою работу в удаленный репозиторий с помощью следующей команды: + +```bash + git push --set-upstream origin +``` + +:::tip[Не запоминай команду] +Тебе не нужно запоминать команду в точности. Нужно просто запомнить `git push`, и если ты впервые пушишь эту ветку, `git` подскажет тебе полную команду. +::: + +## Отправь свое решение в основной репозиторий + +Теперь вся твоя работа находится в твоем экземпляре репозитория Angular Challenges. + +Следующий шаг - перейти на главную страницу [Angular Challenges](https://github.com/tomalaforge/angular-challenges) и создать новый запрос на слитие (Pull Request). + +Github должен показать уведомление, чтобы помочь тебе создать pull request. + +Если этого не случилось, то ты либо неправильно выполнил один из предыдущих шагов, либо можешь перейти на вкладку Pull Request и нажать кнопку New pull request. + +После того как выберешь две ветки для сравнения, ты попадешь на следующую страницу: + +![New pull request screen](../../../../assets/new-pull-request.png) + +В заголовке напиши Answer:, затем номер твоего задания. После этого можешь добавить все, что пожелаешь. + +:::danger[Опасно] +Это очень важно. Это позволит другим узнать, какое испытание ты пытаешься решить. +::: + +В разделе описания ты можешь добавить вопросы, проблемы, с которыми столкнулся, или все остальное, чем захочешь поделиться. Если написать нечего, можешь оставить этот раздел пустым. + +Теперь можешь нажать на Create pull request. + +Я прочитаю и прокомментирую когда у меня будет свободное время. + +

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

+ +:::note[Примечание] +Все желающие могут оставлять комментарии и читать другие PR. +::: + +:::tip[OSS чемпион] +🔥 После того как ты пройдешь это руководство, ты готов внести свой вклад в любой другой публичный репозиторий Github и отправить PR. Это настолько просто.🔥 +::: diff --git a/docs/src/content/docs/ru/index.mdx b/docs/src/content/docs/ru/index.mdx index 6bb6ab4..2593c0b 100644 --- a/docs/src/content/docs/ru/index.mdx +++ b/docs/src/content/docs/ru/index.mdx @@ -9,11 +9,11 @@ hero: file: ../../../assets/angular-challenge.webp actions: - text: Начать - link: /es/guides/getting-started/ + link: /ru/guides/getting-started/ icon: right-arrow variant: primary - text: Перейти к последней задаче - link: /es/challenges/angular/39-injection-token/ + link: /ru/challenges/angular/39-injection-token/ icon: rocket - text: Добавить звезду link: https://github.com/tomalaforge/angular-challenges