it-swarm-vi.com

Làm cách nào để đóng góp mã cho Joomla?

Tôi biết rằng mã được quản lý tại https://github.com/j Joomla/j Joomla-cms (đối với CMS ít nhất) và tôi nên gửi yêu cầu kéo để đề xuất mã đó được thêm vào.

Tôi đặc biệt quan tâm đến bất kỳ mẹo hay nào về việc quản lý các đóng góp của mình và đảm bảo rằng mã được đặt đúng chỗ.

Tôi có nên sử dụng các chi nhánh khác nhau trong repo ngã ba của mình để quản lý các đóng góp khác nhau không? Nếu vậy, cách tốt nhất để liên kết nhánh đó trở lại các nhánh chính trong repo Joomla là gì?

Có một phương pháp tốt để giữ cho bản sao của tôi cập nhật?

Bất kỳ đề xuất về một luồng tốt để quản lý quá trình này sẽ thực sự hữu ích!

19
David Fritsch

Thật tốt khi có một nhánh dành riêng cho mỗi Yêu cầu Kéo bạn sẽ thực hiện.

Một trong những cách đơn giản nhất để tạo một nhánh mới cập nhật là chỉ sử dụng gui web GitHub để chỉnh sửa tệp trong kho lưu trữ ban đầu. Khi lưu, GitHub sẽ tự động tạo một nhánh mới trong ngã ba của bạn dựa trên nhánh bạn hiện đang chỉnh sửa. Nếu bạn muốn chỉnh sửa nhiều tệp hơn, bạn có thể chỉnh sửa chúng trong nhánh mới được tạo và cập nhật của mình.

Nếu bạn đã quen thuộc với Git, thì bạn sẽ khởi động lại nhánh phân nhánh của mình với nhánh gốc ngược dòng để nó đồng bộ trước khi bạn tạo các nhánh mới. Ngoài ra nếu bạn phải cập nhật PR, bạn nên khởi động lại nó thay vì hợp nhất chủ. Trong khi cả hai cách đều hoạt động, các cam kết hợp nhất chỉ tạo ra lịch sử xấu và khó bị đè bẹp hơn.

Nói chung, PR nên là "nguyên tử". Điều này có nghĩa là nếu bạn cố gắng sửa một cái gì đó, chỉ sửa lỗi cụ thể đó. Không sửa hai lỗi khác nhau trong cùng một PR và cũng không sửa lỗi kiểu mã hóa. Việc kiểm tra sẽ dễ dàng hơn và cũng ít có khả năng tạo ra xung đột nếu PR tồn tại lâu hơn một chút so với dự kiến.

Và tất nhiên, thêm một mô tả hay về những gì bạn muốn làm và kiểm tra hướng dẫn để tái tạo vấn đề và kiểm tra sửa lỗi của bạn :-)

10
Bakual

Một điều quan trọng giúp nhóm các đóng góp của bạn là chuyển từng đóng góp thành một nhánh riêng, được đặt tên thích hợp. Nếu bạn đang thêm một tính năng, hãy sử dụng tiền tố như feature- và thêm một hoặc hai mô tả tính năng Word cho tên chi nhánh. Nếu đó là một sửa lỗi trong lớp JForm, hãy sử dụng bugfix-jform. Điều này làm cho nó thực sự dễ dàng xác định những gì bạn đang làm việc bằng cách kiểm tra các nhánh git của bạn thông qua git branch -a.

4
Don Gilbert