Сначала спасибо за ваш интерес к внесению вклада! Надеемся, что это будет приятным опытом для вас, и вы вернетесь, чтобы продолжить вносить вклад.
Пожалуйста, посетите нашу страницу Участие для получения более подробной информации о том, как можно внести свой вклад.
Этот проект и все участники, участвующие в нем, регулируются кодексом поведения Apache Software Foundation. Участвуя, вы обязаны придерживаться этого кодекса. Если вам известно о недопустимом поведении, пожалуйста, посетите страницу Руководства по отчетам и следуйте указаниям там.
Большинство наших вкладов являются вкладами кода, но вы также можете внести вклад в документацию, вики и т.д., или просто сообщить о надежных багах для нас, чтобы мы могли их исправить.
Пожалуйста, просмотрите наш руководство по тому, как отправить отчет о баге. Эта страница также имеет ссылки на другие ресурсы, которые помогут вам.
Проект Apache Tomcat использует POEditor для управления файлами локализации. Для получения дополнительной информации посмотрите здесь### Ваш первый вклад кода
Не уверены, где начать вносить вклад в Tomcat? Вы можете начать с просмотра задач, помеченных словом "Beginner". Ссылка ниже. Пожалуйста, обратите внимание, что ключевое слово "Beginner" довольно ново для проекта, поэтому если нет открытых задач в фильтре, не стесняйтесь обращаться на список рассылки dev.
Вышеуказанный список показывает все задачи, помеченные словом "Beginner" и находящиеся в открытом доступе в текущих поддерживаемых версиях Tomcat (9.0, 10.1, 11.0 и 12.0).
Если вы предпочитаете C перед Java, вы также можете взглянуть на продукты tomcat-native и Tomcat Connectors в Bugzilla.
Вы взволнованы? В этом разделе вы узнаете, как предоставить патч членам команды проекта для проверки и принятия.
Вы можете предоставить патч одним из следующих способов (в порядке предпочтения):
Также стоит отметить, что использование термина "Beginner" относится к новым участникам проекта, которым требуется помощь в ориентировании в процессе внесения вклада.* GitHub Pull Request
Теперь, когда вы выбрали способ отправки патча, вам потребуется получить исходный код.
Этот метод работает, если вы хотите отправить патч через электронную почту, но различие между использованием распределения исходного кода и системы управления версиями заключается в необходимости генерировать патч-файл самостоятельно с помощью diff
. Если это то, что вам нужно, вы можете скачать исходный код с раздела "Распределения исходного кода" страницы загрузок:
Если вы выбрали прикрепление патча к задаче в Bugzilla (или отправку его через электронную почту), вам потребуется скачать исходный код, сделать необходимые изменения и затем сгенерировать патч-файл самостоятельно с помощью diff
(или любого другого инструмента).
Чтобы отправить GitHub Pull Request, вам потребуется форкнуть репозиторий, клонировать ваш форк для выполнения работы:
$ git clone https://github.com/$USERNAME/tomcat.git
и затем отправить ваши изменения и создать Pull Request через графический интерфейс GitHub.
Может занять некоторое время для проверки другими участниками проекта. Будьте терпеливы в это время,
так как все участники являются добровольцами. Если значительное количество времени прошло с момента вашего запроса,
например несколько месяцев, вы можете обновить ваш запрос в Bugzilla, Pull Request или отправить письмо на список рассылки разработчиков
сообщением о необходимости рассмотреть ваш запрос. Иногда вещи теряются среди множества задач, и нам нужна напоминание
Специальная поддержка сред разработки для Eclipse, IntelliJ IDEA и NetBeans обеспечивается через специальные цели Ant:
ant ide-eclipse
ant ide-intellij
ant ide-netbeans
```Просто выполните цель Ant для вашей среды разработки после получения исходного кода,
чтобы установить соответствующие конфигурационные файлы.
Также убедитесь, что вы повторно выполняете цель после перехода между ветками или
после получения последних изменений из основной ветки, чтобы обеспечить синхронность ваших конфигураций среды разработки.## Руководство по стилю кодирования
Apache Tomcat имеет очень слабо определённые правила оформления кода, но следующие рекомендации могут быть полезны:
* Используйте пробелы для отступов, а не табуляцию
* Ширина строки 120 символов для Java-источников, 80 символов для источников документации (.txt, .xml)
* Java-источник: фигурные скобки в конце строки, отступы из четырёх пробелов
* XML-источник: отступы из двух пробелов
## Мы что-то упустили?
Вы просмотрели это руководство и нашли его недостаточным? Или вы запутались в некоторых шагах?
Если да, пожалуйста, дайте нам знать! Лучше всего, если вы представите Pull Request для решения проблемы :wink:
Вы можете оставить комментарий после Вход в систему
Неприемлемый контент может быть отображен здесь и не будет показан на странице. Вы можете проверить и изменить его с помощью соответствующей функции редактирования.
Если вы подтверждаете, что содержание не содержит непристойной лексики/перенаправления на рекламу/насилия/вульгарной порнографии/нарушений/пиратства/ложного/незначительного или незаконного контента, связанного с национальными законами и предписаниями, вы можете нажать «Отправить» для подачи апелляции, и мы обработаем ее как можно скорее.
Опубликовать ( 0 )