Это руководство о том, как внести свой вклад в проект Discourse с открытым исходным кодом различными способами, включая продвижение, дизайн, перевод, внесение изменений в код, сообщение об ошибках и финансовую поддержку.
Требуемый уровень пользователя: Вносить вклад может каждый!
Многие увлечённые люди часто спрашивают, как они могут помочь Discourse. Простой ответ: «Вы замечательные!
», и да, существует множество способов внести свой вклад.
Краткое содержание
В этой документации мы рассмотрим:
- Различные способы помочь Discourse
- Пошаговые руководства по участию
- Лучшие практики для каждой формы вклада
- Решения распространённых проблем, с которыми вы можете столкнуться
- Часто задаваемые вопросы о вкладе в проект
Добро пожаловать всем 
Discourse — это проект с открытым исходным кодом. Вопреки распространённому мнению, участие в проекте с открытым исходным кодом не ограничивается написанием кода. Есть и другие важные области, где вы можете проявить себя.
Продвижение 
Один из лучших способов поддержать Discourse — это продвигать его. Рассказывайте о Discourse везде, где можете, но не будьте навязчивы.
Распространённые методы продвижения
- Категория похвалы на Meta: Делитесь своим положительным опытом использования Discourse в категории Community Building > Praise. Также рассмотрите возможность оставить отзыв о Discourse на этих сторонних сайтах.
- X (ранее Twitter): Используйте @discourse, чтобы делиться историями вашего сообщества. Мы читаем все ваши публикации.
- Другие социальные сети: У нас могут не быть официальных аккаунтов на других платформах, но это всё равно отличное место, чтобы рассказать людям о Discourse.
- Встречи: Присоединяйтесь к встречам или организуйте их через такие платформы, как meetup.com. Обсуждайте Discourse, общаясь с людьми, интересующимися Ruby, JavaScript и открытым исходным кодом.
Дизайн 
Вы можете внести вклад в дизайн, участвуя в обсуждениях в каналах Contribute > UX или Contribute > Feature. Вы также можете создать тему Customization > Theme или компонент темы Customization > Theme component.
- Изучайте такие дизайны, как Material Design, или компоненты, такие как Header Categories Navbar.
- Следуйте руководствам, таким как Руководство для начинающих по использованию тем Discourse и Руководство разработчика по темам Discourse.
Перевод 
Если вы владеете несколькими языками, внесите свой вклад, переводя Discourse.
- Следуйте руководству по вкладу в перевод.
- Присоединяйтесь к обсуждениям в канале #dev:translations.
Код 
Если вы знакомы с Rails и Ember.js или хотите их изучить, вы можете вносить изменения в код.
- Начните с компонента темы Customization > Theme component или плагина Customization > Plugin.
- Ознакомьтесь с руководствами, такими как Руководство для начинающих по использованию Theme Creator и Создание плагинов Discourse.
- Следуйте руководствам по разработке и вкладу.
Сообщения об ошибках 
Если вы обнаружили ошибки, вы можете помочь, сообщив о них.
- Убедитесь, что ошибку можно воспроизвести.
- Следуйте руководству по созданию отчёта об ошибке.
Финансовая поддержка 
Если у вас или вашей организации больше финансовых ресурсов, чем времени, рассмотрите возможность подписки на наш платный хостинг. Мы не принимаем пожертвования, но оплата нашего хостинга напрямую идёт той же основной команде, которая разрабатывает Discourse.
Часто задаваемые вопросы
С чего начать?
При таком количестве вариантов выбор может показаться сложным. Вот несколько советов:
- Читайте всё: Начните со Главной страницы, чтобы быть в курсе основных событий.
- Делайте то, что, по вашему мнению, должны делать другие: Если вы считаете, что сообщество может извлечь пользу из чего-то, просто сделайте это.
Могут ли участники получать оплату?
Да, некоторые виды вклада оплачиваются либо компанией Discourse, либо третьими лицами. Мы приветствуем оплачиваемый вклад, но понимаем, что это не всегда возможно. Независимо от того, как это происходит, вклад должен в идеале мотивироваться внутренним желанием и стремлением развивать проект и сообщество Discourse.