Как добавить своё: с нуля

На странице «Сообщество» лежат материалы, которые сделали сами студенты. Добавить туда своё может каждый — эта страница проведёт за руку: объяснит слова, покажет пример и даст потренироваться на безопасной копии формы. Если у тебя ещё нет аккаунта на GitHub — сначала загляни в главу «GitHub с нуля: регистрация и первые шаги», она такая же пошаговая.

Что такое пресет

На платформе есть тренажёры: карточки слов, «собери фразу», печать кода, «предскажи вывод». Сами тренажёры — это движки, а слова и фразы для них — данные. Пресет — это и есть набор данных для тренажёра: например, твои 20 карточек «термин — перевод» по теме, которую вы сейчас проходите. Отправишь пресет в каталог — и любой сможет нажать «Запустить» и тренироваться на твоём наборе. Придумать и проверить набор проще всего мышкой в конструкторе «Зал»: собери его в форме и нажми «Запустить» — сразу видно, так ли работает тренажёр, как ты задумал. Кнопки «покажи JSON» в конструкторе нет: «Поделиться» копирует ссылку на готовый набор (её удобно кинуть другу), а для заявки в каталог тот же набор набирают текстом по образцу ниже — это пара строк.

JSON на пальцах

JSON (читается «джейсо́н») — это просто способ записать данные текстом так, чтобы их поняла программа. Никакого программирования: только фигурные скобки, кавычки и пары «название: значение». Вот целый пресет для тренажёра «собери фразу» — наведи (или ткни) на каждую часть, чтобы понять, что она делает:

{ "engine": "wordorder", "phrase": "please review my pull request" }

Три самые частые ошибки новичка: потерять кавычку, потерять запятую между полями и поставить одинарные кавычки вместо двойных. Хорошая новость: и бот, и тренажёр ниже вежливо скажут, что именно не так.

Как отправить: по шагам

1. Возьми у наставника секретный код. Это пароль-пропуск: по нему бот понимает, что заявка от своего. Никому его не пересылай.
2. Подготовь данные. Для пресета — JSON по образцу выше (сам набор можно сперва собрать и погонять в конструкторе «Зал»). Для ссылки на свой репозиторий или полезный инструмент — просто адрес, начинающийся с https://.
3. Открой форму заявки (нужен вход в GitHub-аккаунт): «Материал в каталог сообщества». Это issue-форма — анкета с полями, как ниже в тренажёре. Форма живёт в закрытом репозитории лидерборда: если вместо неё открылась страница 404 — значит, доступ тебе ещё не выдали. Это не поломка: попроси наставника добавить тебя, приглашение придёт на почту (и будет видно на самой странице репозитория), после него ссылка откроется.
4. Заполни поля: секретный код, тип (preset / repo / link / video / source), заголовок карточки, главу (если материал по конкретной главе) и данные. Главу указывай коротким id — это последний кусок адреса страницы главы, буква в букву: для /docs/mobile/kotlin-vars это kotlin-vars (раздел mobile/ не пишем), а для /docs/foundation/02b-english-practice — 02b-english-practice, вместе с 02b в начале. Проще всего открыть главу и скопировать хвост адреса из строки браузера: ошибёшься на один символ — бот заявку примет, но с главой материал не свяжется и в её блоке «Видео и источники» не появится. Только строчные латинские буквы, цифры и дефис — иначе бот заявку не примет.
5. Нажми зелёную кнопку Submit new issue внизу формы. Всё, заявка ушла.

Что произойдёт дальше

Заявку читает не человек, а робот (GitHub Actions) — обычно в течение минуты-двух. Он сверит секретный код и проверит данные. Если всё хорошо — под твоей заявкой появится комментарий «Принято!», а материал через пару минут — на странице «Сообщество». Если что-то не так — бот напишет список причин по-русски; исправь данные и отправь новую заявку, код тот же. Захочешь обновить материал — просто отправь заявку ещё раз с новой версией.

Потренируйся без отправки