Як я можу внести код у Joomla?


19

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

Мене особливо цікавлять будь-які хороші поради щодо управління своїми внесками та переконання, що код потрапить у потрібне місце.

Чи варто використовувати різні відділення у роздвоєному репо для управління різними внесками? Якщо так, то який найкращий спосіб зв’язати цю гілку з головними гілками репортажу Joomla?

Чи є хороший спосіб оновити свою роздрібнену копію?

Будь-які пропозиції щодо хорошого потоку управління цим процесом були б дуже корисними!

Відповіді:


10

Завжди добре мати спеціальний відділення для кожного запиту на виклик, який ви збираєтеся зробити.

Один з найпростіших способів створення новітньої нової гілки - це просто використовувати веб-gui GitHub для редагування файлу в оригінальному сховищі. Під час збереження GitHub автоматично створить нову гілку у вашій вилці на основі гілки, яку ви зараз редагуєте. Якщо ви хочете редагувати більше файлів, ви можете їх редагувати у новоствореній та оновленій гілці.

Якщо ви трохи знайомі з Git, то ви перезавантажте свою розгалужену гілку для розміщення з початковою початковою гілкою, щоб вона синхронізувалася перед створенням нових гілок. Крім того, якщо вам доведеться оновити PR, рекомендується перезавантажити його замість об'єднання головного. У той час як обидва способи працюють, merge-comits просто створюють погану історію і їх важче розчавити.

Взагалі кажучи, PR повинні бути "атомними". Це означає, що якщо ви намагаєтеся щось виправити, виправляйте лише цю помилку. Не виправляйте дві різні помилки в одному PR, а також не виконайте виправлень кодового стилю. Це легше перевірити, а також менше шансів створити конфлікти, якщо PR живе трохи довше, ніж очікувалося.

І, звичайно, додайте хороший опис того, що ви хочете зробити, та інструкції з тестування, щоб відтворити проблему та перевірити своє виправлення :-)


4

Одна важлива річ, яка допомагає згрупувати свої внески, - це перемістити кожен внесок у окрему, відповідно названу галузь. Якщо ви додаєте функцію, використовуйте префікс типу feature-та додайте опис функції одного чи двох слів для назви гілки. Якщо це виправлення помилок у JFormкласі, використовуйте bugfix-jform. Це дозволяє дуже легко визначити, над чим ви працюєте, перевіривши свої гілки git git branch -a.

Використовуючи наш веб-сайт, ви визнаєте, що прочитали та зрозуміли наші Політику щодо файлів cookie та Політику конфіденційності.
Licensed under cc by-sa 3.0 with attribution required.