diff --git a/docs/src/content/docs/ru/guides/create-challenge.md b/docs/src/content/docs/ru/guides/create-challenge.md new file mode 100644 index 0000000..7810973 --- /dev/null +++ b/docs/src/content/docs/ru/guides/create-challenge.md @@ -0,0 +1,54 @@ +--- +title: Создай свое испытание +description: Руководство по созданию испытания +sidebar: + order: 5 +--- + +У тебя есть идея, которой ты хочешь поделиться, интересная ошибка, с которой ты борешься в одном из своих приватных или побочных проектов, или трюк Angular, который ты обнаружил. Все эти возможности - хорошая отправная точка, чтобы создать задачу и поделиться ее решением с другими. + +Но как начать создавать испытания? + +## Шаблон создания испытания + +Чтобы упростить этот процесс, я создал генератор Nx, который настроит все за тебя и поможет тебе быстрее начать. Проще всего его запустить в консоли Nx: перейди в раздел Nx Console > generate > @angular-challenges/cli - challenge + +### Параметры + +#### обязательные параметры + +- title: Название, которое ты хочешь дать испытанию. + :::note[Примечание] + Название должно быть не больше 25 символов. + ::: + +- challengeDifficulty: Сложность испытания. Есть три уровня сложности : 🟢 простой / 🟠 средний / 🔴 трудный +- name: Имя NX приложения. + :::note[Примечание] + Имя должно быть написано **kebab-case** + ::: +- docRepository: Категория испытания: Nx, Angular, Angular Performance, Rxjs, NgRx, Typescript. + +#### не обязательные параметры + +- directory: Если ты хочешь, чтобы приложение находилось в определенной папке внутри `apps`. +- addTest: Если хочешь добавить конфигурацию теста. + +### Что будет создано + +- Генератор создаст все файлы, необходимые для нового рабочего приложения. Все эти файлы будут созданы внутри `apps/${directory}/${name}` +- Файл Markdown с минимальными настройками будет создан внутри `docs/src/content/docs/challenges/${docRepository}` + +## Создание испытания + +Все что осталось - создать испытание. 🚀 + +:::danger[Опасно] +Не забудь обновить документацию, чтобы описать свою задачу и дать инструкции. +::: + +Дальше действовать будешь ты!!! 💪 + +## Отправка решения + +Через неделю или около того не забудь представить свое решение задачи.