1 В избранное 0 Ответвления 0

OSCHINA-MIRROR/apache-tomcat

Присоединиться к Gitlife
Откройте для себя и примите участие в публичных проектах с открытым исходным кодом с участием более 10 миллионов разработчиков. Приватные репозитории также полностью бесплатны :)
Присоединиться бесплатно
Клонировать/Скачать
CONTRIBUTING.md 11 КБ
Копировать Редактировать Web IDE Исходные данные Просмотреть построчно История
Отправлено 08.03.2025 09:09 a6d9a28

Внесение вклада в проект Apache Tomcat

Сначала спасибо за ваш интерес к внесению вклада! Надеемся, что это будет приятным опытом для вас, и вы вернетесь, чтобы продолжить вносить вклад.

Пожалуйста, посетите нашу страницу Участие для получения более подробной информации о том, как можно внести свой вклад.

Код поведения

Этот проект и все участники, участвующие в нем, регулируются кодексом поведения 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

  • Прикрепление патча к задаче в Bugzilla
  • Отправка патча на почтовый адрес списка рассылки разработчиков. Этот метод не рекомендован, но если нет связанной с патчем задачи в Bugzilla или вам требуется проверка разработчиками, можно использовать электронную почту.#### Получение исходного кода

Теперь, когда вы выбрали способ отправки патча, вам потребуется получить исходный код.

Скачивание распределения исходного кода

Этот метод работает, если вы хотите отправить патч через электронную почту, но различие между использованием распределения исходного кода и системы управления версиями заключается в необходимости генерировать патч-файл самостоятельно с помощью diff. Если это то, что вам нужно, вы можете скачать исходный код с раздела "Распределения исходного кода" страницы загрузок:

Ручное создание патча

Если вы выбрали прикрепление патча к задаче в Bugzilla (или отправку его через электронную почту), вам потребуется скачать исходный код, сделать необходимые изменения и затем сгенерировать патч-файл самостоятельно с помощью diff (или любого другого инструмента).

GitHub

Чтобы отправить GitHub Pull Request, вам потребуется форкнуть репозиторий, клонировать ваш форк для выполнения работы:

$ git clone https://github.com/$USERNAME/tomcat.git

и затем отправить ваши изменения и создать Pull Request через графический интерфейс GitHub.

Отправка вашего патча!После выбора метода отправки, получения исходного кода и устранения проблемы, пора отправить вашу работу. На этом этапе следует просто использовать ранее выбранный метод отправки.* GitHub PR — после решения проблемы в вашем локальном форке и отправки изменений в ваш репозиторий, откройте GitHub PR для проверки.

  • Прикрепление патча к задаче в Bugzilla — прикрепите патч к задаче в Bugzilla.
  • Электронная почта — снова, этот метод не рекомендован, но вы можете отправить патч на список рассылки разработчиков для проверки.

Ожидание отзыва

Может занять некоторое время для проверки другими участниками проекта. Будьте терпеливы в это время, так как все участники являются добровольцами. Если значительное количество времени прошло с момента вашего запроса, например несколько месяцев, вы можете обновить ваш запрос в Bugzilla, Pull Request или отправить письмо на список рассылки разработчиков сообщением о необходимости рассмотреть ваш запрос. Иногда вещи теряются среди множества задач, и нам нужна напоминание :smile:

Поддержка сред разработки

Специальная поддержка сред разработки для 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 )

Вы можете оставить комментарий после Вход в систему

1
https://api.gitlife.ru/oschina-mirror/apache-tomcat.git
git@api.gitlife.ru:oschina-mirror/apache-tomcat.git
oschina-mirror
apache-tomcat
apache-tomcat
main