Добавление новых примеров кода
Руководство по добавлению примеров кода
- Материалы должны быть написаны на английском языке.
- Задокументируйте ваш пример как можно подробнее.
- Убедитесь, что ваш код работает и был должным образом протестирован.
Мы оставляем за собой право:
- Изменять ваш материал после его отправки.
- Удалить ваш материал в случае необходимости.
Создание нового примера кода
1. Сделайте форк (Fork) этого репозитория
2. Клонируйте ваш форк и перейдите в директорию проекта (cd)
3. Установите VitePress
Предварительные требования для установки VitePress можно найти в официальной документации.
sh
npm add -D vitepress@nextsh
pnpm add -D vitepress@nextsh
yarn add -D vitepress@next vuesh
bun add -D vitepress@next4. Добавьте ваш пример кода
4.1 Создайте файл примера
- Создайте новый файл в
/docs/examples, названный в честь языка программирования. - Имя файла должно оканчиваться на
.md. - Включите как минимум два различных способа выполнения API-запросов.
4.2 Добавьте пример в боковое меню (sidebar)
- Откройте
/docs/.vitepress/config.mts. - Найдите раздел "Code Examples" в боковом меню.
- Добавьте ваш новый файл в список.
- Сохраняйте алфавитный порядок списка по названию языка программирования.
5. Запустите сервер разработки
Перед созданием pull request убедитесь локально, что ваши изменения ничего не нарушили.
sh
npm run devsh
pnpm run devsh
yarn devsh
bun run dev6. Создайте Pull Request
Отправьте pull request в оригинальный репозиторий.