Внести свой вклад в XOD
XOD — это программное обеспечение с открытым исходным кодом. Любая помощь, которая делает проект лучше, будет оценена. Вы можете внести свой вклад даже без написания единой строчки кода. Ниже приводится краткое описание возможностей.
Оценки и отношения #
Выразите свое отношение к запланированным изменениям, пожеланиям, идеям и возражениям одним щелчком мыши. Просматривайте ошибки и предложения в репозитории GitHub и посты на XOD форуме, добавляйте ваши оценки 👍👎❤️, чтобы сообщить нам, что тема важна и значительна. Если мы видим, что предложение важно для сообщества, мы можем повысить её приоритет и ускорить реализацию. Не стесняйтесь и используйте оценки ПРОТИВ, они помогают нам принимать правильные решения.
Чтобы придать нам немного мотивации, поставьте звезду в XOD репозитории на GitHub.
Общение на форуме #
XOD форум - это основное место, где новички просят помощи, а опытные кодеры оставляют запросы функций и предложения. Это место обсуждений. Чем больше людей делятся своим опытом и мыслями, тем лучший продукт мы сможем сделать.
Сообщения об ошибках #
Если какая-то функция в программе выполняется с ошибкой, помогите выследить эту ошибку, сообщая точные шаги, чтобы каждый мог воспроизвести эту проблему.
Попытайтесь сузить свой сценарий до минимального рабочего / неудачного примера. То есть, если у вас есть большая программа, вызывающая проблему, начните с удаления частей, не относящийся к проблеме и наблюдайте за результатом: есть ли еще ошибка? Повторяйте, пока не получите самую простую последовательность шагов для воспроизведения ошибки.
Вы можете сообщить об ошибке на форуме или в GitHub. Подследний вариант предпочтительней, так как в GitHub ставятся задачи для основных разработчиков, а форум ещё нужно пересматривать и всё равно переносить ошибки в GitHub. Отправляя отчет напрямую вы экономите свое время, а мы можем решить проблему быстрее.
Используйте Шаблон оформления ошибки для предоставления максимально детальной информации.
Исправление грамматики #
Разработчики XOD не являются носителями английского языка. Так что мы допускаем грамматические ошибки, опечатки и иногда неправильную формулировку. Помогите XOD оправдать ваши ожидания.
Фразы, которые вы видите в XOD IDE, использованы где-то в исходном коде XOD, который открыт и доступен на GitHub. Вы можете отредактировать файл и отправить нам запрос на перенос через веб-интерфейс GitHub без установки чего-либо:
- Введите термин, который вы хотите изменить в GitHub repository search, найдите и откройте файл с ошибкой.
- Как редактировать файлы в репозитории другого пользователя.
Если вы хотите сразу просмотреть кучу пользовательских интерфейсов, многие из них распространяются по файлам message.js files. Не стесняйтесь редактировать.
Когда ошибка на странице документации, способ редактирования такой же. Для удобства вы можете нажать кнопку “Edit this page”, расположенную в верхней части любой страницы, чтобы перейти непосредственно в нужный исходный файл.
Блог и сообщество #
Чем больше сообщество, тем более динамичная экосистема XOD.
Знают ли ваши друзья и коллеги о XOD? Краткая заметка о XOD в Twitter, блоге или в любом другом информацмонном пространстве поможет распространению это слова и делает его более узнаваемым и популярным.
Если вы создали какое-то устройство, проект, видео или статью, используя XOD - это круто! Поделитесь им как можно скорее на форуме в разделе Посмотрите, что я сделал. Мы делимся интересными проектами.
Оффлайн-события - это ещё одна плюшка. Вы хотели бы выступить на конференции, встрече или семинаре? Сообщите нам, мы можем поддержать вас в любом случае с помощью оборудования или медиа: напишите сообщение на hello@xod.io.
Создание библиотек #
Если проводите некоторое время с XOD, то шанс, что вы сделали что-то полезное очень высок. Не стесняйтесь добавлять свои полезные функции в библиотеку и публиковать в облаке, чтобы остальные могли основывать свои проекты на ваших достижениях.
Не забудьте поделиться своим итогом работы на форуме в разделе Посмотрите, что я сделал.
Улучшение документации #
Если вы считаете, что документация неполна, неясна или даже ошибочна в некоторых моментах, помогите XOD улучшить её. Добавляйте разделы, переписывайте абзацы, добавляйте примеры, улучшайте стиль по своему усмотрению и отправьте нам запрос на слияние. Этот процесс аналогичен описанному в абзаце Исправление грамматики.
Перевод документации #
Не все знают английский. Вы можете помочь международным пользователям, предоставляя переводы документации.
Любая оригинальная статья содержится в файле README.md где-то в директории /docs/ в репозитории xod-docs. Чтобы сделать перевод, создайте новый файл рядом с README.md с именем, отражающим целевой язык (DE.md, IT.md, PT.md, FR.md, ES.md, UA.md, JA.md, KO.md, CN.md) и отправьте нам запрос на слияние.
Внести свой вклад в код #
Если вы чувствуете свою силу, вы можете попробовать внести свой вклад в основной код. Следуйте основным принципам, описанным в CONTRIBUTING.md в репо GitHub и выберите один из вопросов для работы.
Лучшие кандидаты для начала:
Опубликуйте комментарий к проблеме, если вы готовы за неё взяться. Мы можем предоставить более подробную информацию и ответить на технические вопросы.