Зачем участвовать
Лучшие данные получаются, когда их собирает много людей. Никакая редакция не сравнится с сообществом, которое реально пользуется продуктами и знает индустрию изнутри.
Любой вклад имеет значение:
- Исправил ошибку в данных — информация стала точнее
- Исправил баг — всем стало удобнее
- Перевёл статью — открыл проект новой аудитории
Что можно делать
Данные
- Ошибки — нашёл неточность, сообщи или исправь
- Дополнения — знаешь то, чего у нас нет
- Проверка — подтверди или опровергни существующие данные
- Источники — дай ссылку на официальный источник
Код
- Ошибки — нашёл, исправил
- Фичи — есть идея, реализуй
- Производительность — сделай быстрее
- Документация — объясни как работает
Контент
- Обзоры — на основе реального опыта
- Руководства — полезные материалы
- Переводы — новые языки или улучшение существующих
Как начать
- Прочитай О проекте и Манифест
- Найди что делать:
- Данные — проверь то, в чём разбираешься
- Код — смотри задачи на GitHub, ищи метки для новичков
- Для кода:
git clone https://github.com/affiliatefm/[repo]
npm install
npm run dev
Правила
Качество важнее количества. Один нормальный вклад лучше десяти халтурных.
Проверяй информацию. Не уверен — не пиши. Есть сомнения — укажи источник.
Будь честен. Конфликт интересов — скажи. Работаешь на программу, о которой пишешь — раскрой.
Отправка данных
Простое исправление:
Создай задачу — что не так, как должно быть, откуда информация.
Большое обновление:
Присылай изменения с источниками и объяснением.
Требования к данным
| Критерий | Что значит |
|---|---|
| Проверяемость | Есть источник или можно проверить |
| Актуальность | Текущее состояние, не история |
| Объективность | Факты, не реклама |
| Полнота | Все нужные поля заполнены |
Не принимаем:
- Непроверенные утверждения
- Рекламу под видом данных
- Копипаст с других сайтов
- Данные, полученные нелегально
Код
Процесс
- Сделай копию репозитория
- Создай ветку (
feature/новая-функция) - Внеси изменения
- Протестируй
- Сохрани с понятным сообщением
- Отправь
- Открой Pull Request
Стандарты
- Следуй стилю проекта
- Добавь тесты если нужно
- Обнови документацию
- Один PR — одна задача
Контент
Если пишешь обзоры или статьи:
- Пиши только о том, что реально использовал
- Покрывай плюсы и минусы
- Давай конкретику, не воду
- Раскрывай связи с компаниями
- Ссылайся на официальные источники
Не принимаем:
- Автогенерацию без редактуры
- Плагиат
- Скрытую рекламу
- Слухи и непроверенное
Признание
Все участники указаны в репозиториях. Активные участники влияют на развитие проекта.
Вопросы
- Проверь документацию
- Поищи в закрытых задачах
- Открой обсуждение в репозитории
- Напиши на info@affiliate.fm