Hướng dẫn python open source projects to contribute - dự án mã nguồn mở python để đóng góp

Làm thế nào bạn có thể đóng góp

Tùy thuộc vào sở thích và kỹ năng của bạn, bạn có thể đóng góp theo một số cách khác nhau. Ví dụ: nếu bạn muốn đóng góp cho CPython, bạn có thể:

• Khắc phục lỗi mã
• Viết các bài kiểm tra đơn vị cho các chức năng trong thư viện tiêu chuẩn
• Viết tài liệu cho các chức năng trong thư viện tiêu chuẩn

Nhưng nếu bạn muốn đóng góp trong các lĩnh vực khác, bạn có thể:

• Viết tài liệu cho hướng dẫn của nhà phát triển Python
• Dịch tài liệu
• Sử dụng các kỹ năng đầu tiên của bạn để cải thiện trang web chính thức của Python

Bạn cũng có thể giúp xem xét các yêu cầu kéo từ những người đóng góp khác. Các nhà phát triển cốt lõi có rất nhiều công việc trong tay, vì vậy nếu bạn có thể giúp đưa một số vấn đề về phía trước, thì bạn sẽ giúp Python trở nên nhanh hơn.core developers have a lot of work on their hands, so if you can help move some issues forward, then you’ll be helping Python get better faster.

Làm thế nào để có được các tài nguyên mà bạn sẽ cần

Khi bạn bắt đầu đóng góp cho một dự án nguồn mở, có thể có rất nhiều thông tin cần thực hiện cùng một lúc.

Để giúp bạn điều hướng tất cả, cổng đầu tiên của bạn phải là hướng dẫn của nhà phát triển Python. Nó là một nguồn tài nguyên siêu quan trọng mà tất cả những người đóng góp và nhà phát triển cốt lõi dựa vào vì nó bao gồm mọi thứ từ cách đánh giá một đóng góp tiềm năng vào cách giao dịch sẽ phát hành theo dõi. (Nếu bạn đóng góp cho hướng dẫn này, thì bạn sẽ có thể tạo ra một tác động lớn đến những gì đóng góp cho Python là như thế.)

Khi bạn xuống các loại hạt và bu lông đóng góp, nó sẽ hữu ích để làm quen với một vài công cụ:

• GitHub: Những người đóng góp Python hợp tác với nhau thông qua GitHub, cho phép bạn lưu trữ mã, kiểm soát phiên bản, đưa ra phản hồi và hơn thế nữa. Để tìm hiểu thêm về cách sử dụng công cụ này, hãy xem Giới thiệu về Git và GitHub cho các nhà phát triển Python cũng như Git Bootcamp và Cheat Sheet chính thức của Python. Python contributors collaborate with each other through GitHub, which allows you to host code, do version control, give feedback, and more. To learn more about how to use this tool, check out Introduction to Git and GitHub for Python Developers as well as Python’s official Git Bootcamp and Cheat Sheet.

• Tái cấu trúcText: Nếu bạn muốn đóng góp tài liệu, thì nó sẽ rất hữu ích để tìm hiểu cách sử dụng ngôn ngữ đánh dấu này. Hướng dẫn của nhà phát triển Python có một đoạn giới thiệu về ResformuredText để giúp bạn bắt đầu. (Sự thật thú vị: Tái cấu trúc đã tồn tại lâu hơn Markdown!) If you want to contribute documentation, then it’ll be very helpful to learn how to use this markup language. The Python Developer’s Guide has a primer on reStructuredText to help you get started. (Fun fact: reStructuredText has been around longer than Markdown!)

• Sphinx: Bạn sẽ sử dụng Sphinx để xây dựng tài liệu Python. Để tìm hiểu thêm, bạn có thể xem giới thiệu nói chuyện của Mariatta Wijaya, về Sphinx Docs và ReserfuredText và Eric Holscher, Talk Talking ghi lại dự án của bạn với Sphinx và đọc tài liệu. You’ll use Sphinx to build Python’s documentation. To learn more, you can check out Mariatta Wijaya’s talk Introduction to Sphinx Docs and reStructuredText and Eric Holscher’s talk Documenting your project with Sphinx & Read the Docs.

Mặc dù bạn không cần phải có kinh nghiệm với ngôn ngữ lập trình C để đóng góp cho Python, nhưng nó có thể mở ra một số cách đóng góp mới. Dưới đây là một số tài nguyên bạn có thể kiểm tra để tìm hiểu thêm:C programming language to contribute to Python, it can open up some new ways of contributing. Here are some resources you can check out to learn more:

• C cho các lập trình viên Python
• Hướng dẫn của bạn về mã nguồn cpython
• CPYThon Internals: Hướng dẫn của bạn về trình thông dịch Python 3

Để có cảm giác về cách các khía cạnh giữa các cá nhân của việc đóng góp cho công việc của Python, bạn cũng có thể kiểm tra các kỳ vọng của Brett Canon, Pycascades nói về sự tham gia của nguồn mở. Nó nói về việc thiết lập những kỳ vọng hợp lý của nhau để chúng tôi có thể làm cho nguồn mở dễ chịu cho mọi người tham gia.

Cách chọn vấn đề đầu tiên của bạn

Nếu bạn thấy một cái gì đó trong Python mà bạn nghĩ nên được cải thiện, thì bạn có thể chào đón nó. Nhưng đối với đóng góp đầu tiên của bạn, có thể dễ dàng hơn để bắt đầu với một vấn đề đã được người khác gắn cờ.issue that has already been flagged by someone else.

Nếu bạn muốn đóng góp cho hướng dẫn của nhà phát triển Python hoặc trang web chính thức của Python, thì bạn có thể xem các vấn đề được liệt kê trên GitHub:

• Các vấn đề hướng dẫn của nhà phát triển Python
• các vấn đề python.org

Nếu bạn muốn đóng góp cho Cpython, đó là ý nghĩa của hầu hết mọi người khi họ nói là Py Python, thì bạn sẽ cần tạo một tài khoản tại Trình theo dõi lỗi Python, được gọi là BPO bởi vì nó ở mức tại bugs.____. Bạn có thể tự đăng ký làm người dùng bằng cách truy cập người dùng → Đăng ký trong menu bên trái.BPO because it’s at bugs.python.org. You can register yourself as a user by going to User → Register in the menu on the left.

Thông tin trong chế độ xem mặc định có thể rất nhiều vì nó cho thấy các vấn đề được đưa ra bởi người dùng cũng như các vấn đề được đưa ra bởi các nhà phát triển cốt lõi, có thể đã được khắc phục. May mắn thay, bạn có thể lọc danh sách này để tìm chính xác những gì bạn đang tìm kiếm.

Để lọc danh sách, hãy bắt đầu bằng cách đăng nhập và sau đó truy cập các truy vấn của bạn → Chỉnh sửa trong menu bên trái. Bạn sẽ nhận được một danh sách các truy vấn mà bạn có thể để lại hoặc bỏ đi:queries that you can leave in or leave out:

Dưới đây, một ví dụ về những gì bạn đã thấy nếu bạn đã chỉnh sửa các truy vấn của mình để chỉ trong các vấn đề tài liệu dễ dàng:

Bây giờ bạn đã lọc danh sách của mình để chỉ trong các vấn đề tài liệu dễ dàng, bạn sẽ thấy các vấn đề tài liệu phù hợp cho người mới bắt đầu.

Nếu bạn muốn làm việc trên một cái gì đó khác ngoài tài liệu, bạn cũng có thể thử một số truy vấn khác để giúp bạn tìm thấy một vấn đề khiến bạn quan tâm:

Khi bạn đã quyết định vấn đề nào bạn muốn giải quyết cho đóng góp đầu tiên của mình, thật tốt khi kiểm tra các bình luận để xem nếu:comments to see if:

• Vẫn còn một số cuộc thảo luận đang diễn ra về việc liệu nó có nên được giải quyết hay không và nên tiếp cận như thế nào
• Người khác đã làm việc về vấn đề

Bạn cũng có thể kiểm tra phiên bản mới nhất của mã và tài liệu để xem liệu vấn đề đã được giải quyết nhưng chưa được đóng bởi một nhà phát triển cốt lõi chưa.closed by a core developer yet.

Khi bạn đã xác định vấn đề nào bạn muốn bắt đầu, bạn có thể để lại nhận xét về vấn đề này:

• Nói rằng bạn sẽ làm việc với nó
• Cho người khác biết khi nào bạn có kế hoạch gửi yêu cầu kéo của mình

Nếu bạn truyền đạt rõ ràng các kế hoạch của mình, thì những người đóng góp khác sẽ biết rằng người khác đã làm việc về vấn đề này và có thể tập trung năng lượng của họ vào việc giải quyết các vấn đề khác thay thế.

Cách gửi đóng góp đầu tiên của bạn

Hãy chắc chắn kiểm tra tài liệu chính thức của Python về vòng đời của một yêu cầu kéo. Nó sẽ hướng dẫn bạn thông qua các cơ chế từng bước để gửi yêu cầu kéo, cung cấp cho bạn các mẹo để thực hiện các cam kết tốt và hơn thế nữa.

Vì hầu hết các nhà phát triển cốt lõi là tình nguyện viên, bạn có thể không nhận được phản hồi ngay lập tức, nhưng có một vài điều bạn có thể làm để tăng tốc quá trình:

• Đưa ra một lời giải thích rõ ràng về vấn đề bạn đã giải quyết và cách bạn giải quyết nó: Điều này sẽ giúp người đánh giá tăng tốc nhanh chóng và có thông tin họ cần để chấp nhận yêu cầu kéo của bạn. This will help reviewers get up to speed quickly and have the information they need to accept your pull request.
• Chỉ giải quyết một vấn đề trong mỗi yêu cầu kéo: Nếu bạn nhận thấy một vấn đề khác trong khi bạn đang làm việc với sự đóng góp của mình, thì bạn có thể giải quyết nó trong một nhiệm vụ kéo thứ hai. If you notice another problem while you’re working on your contribution, then you can resolve it in a second pull quest.

Đóng góp cho nguồn mở là tất cả về sự hợp tác, vì vậy giao tiếp là siêu quan trọng. Để tìm hiểu thêm, hãy xem những hướng dẫn nguồn mở nào nói về việc giao tiếp hiệu quả khi bạn gửi đóng góp.

Khi bạn đã gửi yêu cầu kéo đầu tiên của bạn, hãy đá lại và ăn mừng! Bạn đã thực hiện bước tiến lớn đầu tiên của mình trên một hành trình có thể dẫn đến một số địa điểm tuyệt vời.

Cái gì tiếp theo?

Nếu bạn quyết định rằng bạn muốn tham gia nhiều hơn, thì có một số cơ hội bạn có thể khám phá. Có lẽ bạn thích:

• Làm việc để trở thành một nhà phát triển cốt lõi
• Tìm kiếm sự cố vấn
• Tham gia nhóm Triage
• Tham gia một nhóm làm việc cho một dự án cụ thể
• Trở thành thành viên của Quỹ phần mềm Python

Có rất nhiều điều đang diễn ra trong thế giới của Python, vì vậy hãy nhìn xung quanh và xem những gì làm bạn thích. Hãy cùng nhau tử tế với nhau và xây dựng một cái gì đó tuyệt vời cùng nhau.

Kết luận: Bắt đầu đóng góp cho Python

Chúc mừng bạn đã thực hiện những bước đầu tiên của bạn để đóng góp cho Python! Nếu bạn tham gia và bắt đầu, thì bạn chắc chắn sẽ học được rất nhiều trong khi tạo ra ảnh hưởng đến một dự án nguồn mở quan trọng.

Trong hướng dẫn này, bạn đã học được:

• Làm thế nào bạn có thể đóng góp cho Python theo cách phù hợp với các kỹ năng và sở thích của bạnskills and interests
• Những tài nguyên và công cụ bạn có thể sử dụng để giúp bạn đóng góp một cách tự tinresources and tools you can use to help you contribute confidently
• Nơi bạn có thể tìm thấy ý tưởng để sửa chữa để đề xuất trong đóng góp đầu tiên của bạnyour first contribution

Tất cả những người mà nhóm trong nhóm phát triển cốt lõi bắt đầu chỉ với một đóng góp, vậy tại sao không thử nó? Bạn chắc chắn sẽ học được điều gì đó trên đường đi!