Как я могу добавить код в Joomla?

Мне известно, что код управляется по адресу https://github.com/joomla/joomla-cms (по крайней мере, для CMS), и что мне следует отправлять запросы на извлечение, чтобы предложить добавить код.

Меня особенно интересуют любые полезные советы по управлению моими вкладами и по обеспечению того, чтобы код попал в нужное место.

Должен ли я использовать разные ветки в моем раздельном репо для управления разными вкладами? Если да, то как лучше связать эту ветку с основными ветками в репозитории Joomla?

Есть ли хороший способ для обновления моей раздвоенной копии?

Любые предложения по хорошему управлению этим процессом были бы очень полезны!

Всегда хорошо иметь выделенную ветку для каждого запроса на извлечение, которое вы собираетесь сделать.

Один из самых простых способов создания новой новой ветки - просто использовать веб-интерфейс GitHub для редактирования файла в исходном репозитории. При сохранении GitHub автоматически создаст новую ветку в вашей ветке на основе ветви, которую вы в данный момент редактируете. Если вы хотите отредактировать больше файлов, вы можете отредактировать их в недавно созданной и обновленной ветке.

Если вы немного знакомы с Git, то вы перебазируете свою разветвленную промежуточную ветвь с исходной веткой восходящего направления, чтобы она синхронизировалась перед созданием новых веток. Также, если вам нужно обновить PR, рекомендуется перебазировать его вместо слияния мастер. В то время как оба способа работают, слияния-коммиты просто создают плохую историю и их сложнее раздавить.

Вообще говоря, PR должны быть «атомными». Это означает, что если вы пытаетесь что-то исправить, исправьте только эту конкретную ошибку. Не исправляйте две разные ошибки в одном и том же PR, а также не делайте исправления стиля кода. Это проще для тестирования, а также меньше вероятность возникновения конфликтов, если PR живет немного дольше, чем ожидалось.

И, конечно, добавьте хорошее описание того, что вы хотите сделать, и инструкции по тестированию, чтобы воспроизвести проблему и проверить исправление :-)

Одна важная вещь, которая помогает группировать ваши вклады, - переместить каждый вклад в отдельную ветвь с соответствующим названием. Если вы добавляете функцию, используйте префикс как feature-и добавьте описание функции из одного или двух слов для имени ветви. Если это исправление ошибки в JFormклассе, используйте bugfix-jform. Это делает его очень легко определить , что вы работаете, проверяя свои GIT ветви через git branch -a.