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

19

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

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

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

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

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

Дэвид Фрич
источник

Ответы:

10

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

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

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

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

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

Bakual
источник
4

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

Дон гилберт
источник