Điều gì cần suy nghĩ khi tạo nguồn mở dự án?

Question

Tôi chỉ sắp công bố một dự án như mã nguồn mở, và sẽ thực sự giống như một số thông tin phản hồi về một vài điều:

1. Mã này là khá sạch sẽ nhưng lịch sử kiểm soát phiên bản không phải là. Sai lầm, mã gỡ lỗi, có lẽ mã không phù hợp, v.v. Tôi có nên xóa lịch sử trước khi xuất bản hoặc nhập nó vào kho lưu trữ công cộng không?

2. Tôi có nên ưu tiên thực hiện hướng dẫn, giải thích tính năng hoặc tài liệu api không?

3. Những suy nghĩ khác khiến cho mọi người dễ dàng tham gia dự án mới?

Answer 1

Theo ý kiến ​​rất khiêm tốn của tôi:

1) Nếu bạn đang thiết lập trên sẽ mã nguồn mở, hãy tự hào về mã của bạn. Chúng ta đều biết có những sai lầm và lỗi trên đường đi. Sẽ có nhiều hơn, vì vậy đừng có cảm giác như bạn không thể hiển thị chúng một cách công khai. Bạn có thể!

2) Chắc chắn. Có lẽ trong đó, trật tự, quá, bởi vì đó là thứ tự mà mọi người sử dụng sản phẩm của bạn sẽ đọc chúng. Họ sẽ phải sử dụng phần mềm của bạn trước khi họ quyết định làm việc trên nó.

3) Lời khuyên tốt nhất tôi có thể đưa ra là có hướng dẫn xây dựng rõ ràng, hy vọng với các tập lệnh giúp mọi người định cấu hình môi trường. Một bệnh dịch phổ biến với phần mềm nguồn mở là yêu cầu các nhà phát triển mới tải xuống hàng tấn thư viện và định cấu hình hộp của họ để hoạt động vừa phải để có thể xây dựng phần mềm. Điều đó, đối với tôi, rất bực bội và có thể khiến tôi rất nhanh chóng.

Chúc may mắn!

Answer 2

1. Hoàn toàn là lựa chọn của bạn, trừ khi bạn sử dụng mã có bản quyền mà bạn không có quyền phân phối hoặc nếu có vấn đề liên quan đến phân phối lại, tín dụng.

2. Khó nói mà không biết nó là gì. Bạn cần những gì để sử dụng? Những gì bạn muốn xem đầu tiên? (Có lẽ là hướng dẫn ...)

3. Có lẽ một ví dụ bắt đầu để hoàn thành bao gồm cài đặt. Có lẽ bạn nên đi đến những rắc rối của việc chạy nó một môi trường ảo hoặc trên một hệ điều hành mới cài đặt, vì vậy bạn chắc chắn rằng hướng dẫn cài đặt của bạn đối phó với tất cả mọi thứ.

Answer 3

1. Nó phải đủ dễ dàng để dẹp một số cam kết với nhau, và nỗ lực sẽ được giá trị nó. Các nhà phát triển thường xem xét lịch sử để có được một cái nhìn sâu sắc về cách dự án được thiết kế như thế nào.
2. Chắc chắn. Ít nhất bạn có thể làm là lấy một số công cụ tài liệu như Doxygen để tạo tài liệu. Hướng dẫn có lẽ là không cần thiết vào thời điểm này; cộng đồng sẽ viết hướng dẫn cho bạn, miễn là mã được tài liệu đẹp.
3. Bao bì tốt luôn giúp ích. Tạo các tệp nhị phân được biên dịch trước cho nhiều hơn một kiến ​​trúc và nếu khả thi, hãy tạo RPM và DEB. Điều này làm giảm rào cản nhập cảnh rất nhiều. Không ai góp phần vào phần mềm mà họ không sử dụng. Bạn cũng có thể sử dụng trình theo dõi lỗi tốt như Bugzilla hoặc sử dụng giải pháp tích hợp như Launchpad hoặc Trac. Đồng thời thiết lập danh sách gửi thư và kênh IRC. Điều này sẽ giúp xây dựng một cộng đồng.