21wiki открыта для участия. Есть три способа сделать вклад — выберите тот, что подходит по времени и техническим навыкам.
Вариант 1 — Предложить (без кода)
Самый простой вклад. Откройте GitHub Issue, чтобы:
- Предложить недостающую тему — что-то, чего пока нет в вики
- Сообщить об ошибке — неточный факт, сломанная ссылка или устаревшие сведения
- Запросить языковой паритет — тема есть на английском, но не на русском (или наоборот)
Вариант 2 — Добавить исходный файл
Вики строится на неизменяемых исходных файлах в raw/, основанных на материалах 21ideas.org и других источниках, посвящённых исключительно Биткоину. Если у вас есть качественный материал, который будет полезен вики, вы можете добавить его в исходную библиотеку.
Правила приёма источников (полный список: docs/CONTRIBUTING.md):
- Принимаются материалы 21ideas.org, первичные биткоин-источники (BIP, тексты Сатоши, официальная документация протокола) и авторитетные образовательные материалы, посвящённые исключительно Биткоину, от признанных авторов и изданий.
- Источники, по которым нужно решение (научные статьи, материалы вне 21ideas.org и т. п.) — сначала откройте issue.
- Не принимаются в основной репозиторий: контент бирж, альткоины и мульти-коин материалы, спекуляции о цене, сторонние блоги без явного биткоин-фокуса.
Использование ingest skill (рекомендуется): откройте Cursor или Claude Code в корне репозитория и запустите:
Нет ИИ-агента? Cursor и Gemini CLI дают бесплатный доступ к агентам. Это отличный способ попрактиковаться.
Сначала скопируйте полный текст статьи — от заголовка до последней строки, включая таблицы, сноски и заключительные заметки. Предпочтителен формат Markdown (например, из режима чтения браузера). Не сокращайте и не пересказывайте. Для страниц, требующих JavaScript (например, stacker.news, Twitter/X), используйте режим чтения браузера, а не «Просмотр исходного кода».
Use docs/INGEST-SKILL.md to add the following article to raw/.
Content: <вставьте полный текст статьи — от заголовка до последней строки>
URL: <вставьте полный URL — обязателен даже при вставке текста>
Author: <имя автора — пропустите, если не уверены>
Published: <ГГГГ-ММ-ДД — пропустите, если неизвестно>
Series: <название серии и номер части, если применимо — пропустите, если не серия>
Notes: <что-то необычное в материале — пропустите, если нечего отметить>
Content и URL обязательны. Остальные поля улучшают результат, но необязательны. Агент определит поддиректорию, проверит дубликаты и соберёт frontmatter — знать структуру репозитория не нужно.
После добавления исходного файла мейнтейнер займётся синтезом вики-страниц — или переходите к Варианту 3.
Вариант 3 — Генерация страниц с помощью ИИ
Полный путь контрибьютора: форкните репозиторий, запустите ИИ-агент локально (Claude Code, Cursor или Gemini CLI) на полном содержимом репозитория, сгенерируйте страницы для обоих языковых слоёв, проверьте линтером и откройте PR.
Этот трек требует локальной среды. Рабочий процесс, правила и промпт для агента — на английском в гайде на GitHub:
PR проверяются мейнтейнером. Синтез вики-страниц из принятых источников выполняется автоматически с помощью вики-скиллов.
Вопросы?
Откройте GitHub Issue с меткой question или присоединяйтесь к сообществу контрибьюторов 21ideas в Telegram.