Дока состоит из двух репозиториев: платформа на базе Eleventy собирает статьи из репозитория с контентом (мы сейчас в нём), и на выходе получается наш красивый сайт.
Дока постоянно развивается. Вы можете писать статьи, помогать с разработкой или редактированием. Вы можете всё! Прекрасный мир опенсорса 🧚♀️
Почитайте, чем можно помочь Доке.
Хотите писать для Доки?
- Форкните этот репозиторий с контентом и склонируйте его к себе.
- Определитесь с форматом материала (дока или статья) и,
- если такой статьи ещё нет, откройте форк в терминале и введите
./new.sh. Когда вы ответите на несколько вопросов, останется открыть созданный файлindex.mdи начать писать. Также можно создать статью вручную по инструкции. - если статья уже есть, откройте её, и можете работать с текстом: вносить изменения, добавлять что-то полезное.
- если такой статьи ещё нет, откройте форк в терминале и введите
- Напишите статью (не забывайте сверяться с руководством по стилю). Всё, что хорошо выглядит в маркдауне, будет хорошо выглядеть на сайте. Если вы хотите предпросматривать статью локально, почитайте инструкцию по предпросмотру.
- Дополнительные материалы: картинки, демки, блок «На практике» сохраняйте в ту же папку, в подпапки images, demos, practice и так далее.
- Закончили? Создайте пулреквест. Вот и всё! После небольшой проверки ваш материал появится на сайте Доки!