5
keys to project success on GitHub
Posted
27 Jan 2016 by Michael
Glukhovsky
Bài
được đưa lên Internet ngày: 27/01/2016
Phát
triển phần mềm hướng cộng đồng đang trở thành cách
thức mới cho sự thành công của thương hiệu và dự án.
Bạn có thể được tư vấn chúy ý tới xu thế đang nổi
lên này: Với hơn 27 triệu dự án hiện có trên GitHub,
sự phổ biến gia tăng chưa từng thấy của sự phát
triển hướng cộng đồng là rõ ràng.
Vì
thế, làm thế nào bạn tham gia vòa lực lượng toàn cầu
theo từng bước công nghệ này được?
Là
người đồng sáng lập ra RethinkDB—
một cơ sở dữ liệu JSON nguồn mở, có khả năng mở
rộng được phạm vi, được thiết kế cho Internet thời
gian thực - tôi đã có vài ý nghĩ về điều đó. Đội
của tôi và tôi đã tạo ra hầu
hết các người sử dụng - người được cấp phép đầy
sao trên GitHub với hàng ngàn những người đóng góp
tự nguyện. Kênh giao tiếp mở trên GitHub đã giúp chúng
tôi phân phối các giải pháp tốt nhất và tạo ra một
sản phẩm được các công ty sử dụng trong các nền công
nghiệp khác nhau, bao gồm một vài công ty trong Fortune 500.
Tôi
đưa ra 5 cách cụ thể bạn cũng có thể làm cho dự án
của bạn thành công trên GitHub. Tất cả đều là về
việc tham gia cộng đồng.
1.
Ưu tiên cho cộng đồng của bạn
Nguồn
mở là hơn chỉ một giấy phép và mô hình phát triển
phần mềm; nó phần lớn là về con người. Hãy khuyến
khích cả những người sử dụng và những người duy trì
cộng tác để thúc đẩy các ý tưởng mới nổi lên. Bạn
sẽ thấy rằng hầu hết các dự án nổi bật kết hợp
một cộng đồng những người đóng góp với một danh
sách thư, dự án trên GitHub, và/hoặc kênh chat IRC/Slack.
2.
Chào đón những người đóng góp mới
Những
người đóng góp thường cảm thấy bị hăm dọa và tự
có ý thức khi bắt đầu một dự án mới. Hãy giúp họ
bứt ra khỏi cái vỏ bọc của họ bằng việc chào một
tập hợp các chỉ dẫn đóng góp và sử dụng trình theo
dõi vấn đề (issue tracker) để nhấn mạnh việc
xử lý sự cố có thể là dễ dàng được những người
đóng góp mới nắm bắt được. Việc đưa ra công việc
cơ bản thích hợp hơn là sống còn cho thành công dự án
của bạn. Ví dụ, khi chúng tôi đã khởi xướng
RethinkDB, chúng tôi cũng đưa ra chỉ
dẫn các vấn đề theo nghi thức của GitHub để giúp
những người sử dụng.
3.
Đánh giá cao công việc của những người đóng góp
Tất
cả những ai đóng góp cho RethinkDB đều là các đồng
sáng tạo và có quyền sở hữu đối với công việc của
họ trong từng dự án. Trong RethinkDB, chúng tôi thừa nhận
từng đóng góp đầu vào của người đóng góp theo các
cách thức khác nhau. Những điều dễ dàng làm dài dài là
shout-outs, một ghi chép hay, hoặc gửi vài gợi ý, như một
chiếc áo T-shirt chẳng hạn. Những người đóng góp giúp
chúng tôi xây dựng RethinkDB theo các cách thức khác nhau,
miễn là nó đệ trình một yêu cầu kéo lên GitHub hoặc
kiểm thử một tính năng mới hoặc nhiệm vụ khác; mỗi
người trong số họ xứng đáng với sự biết ơn từ
chúng tôi.
4.
Sử dụng mỹ thuật để hình dung được các ý tưởng
của bạn
Mỹ
thuật có một khả năng mạnh để truyền đạt các ý
tưởng, giống hệt như phần mềm. Hãy tận dụng thiết
kế đồ họa để tạo thương hiệu cho các dự án của
bạn. (Chúng tôi đã thuê một lập
trình viên toàn thời gian để giúp chúng tôi). Hãy cân
nhắc tạo ra một vật lấy khước thân thiện (như
Octocat của GitHub hoặc Thinker của RethinkDB)
để giúp phân biệt dự án của bạn đối với cộng
đồng của bạn. Hơn nữa, hãy sử dụng mỹ thuật để
minh họa và dạy các ý tưởng và các chỉ dẫn phức
tạp. Bằng việc kết hợp mỹ thuật vào trong dự án của
bạn, bạn cũng có thể khuyến khích những đóng góp nghệ
thuật từ những người đóng góp mới của bạn.
5.
Triển khai làm tài liệu để ngăn ngừa các vấn đề
Việc
ghi lại chóng chán quy trình dự án của bạn có thể ngăn
chặn các vấn đề và sự lúng túng tiềm tàng. Làm tài
liệu tốt bao gồm cả phần các câu hỏi đáp thường
gặp (FAQ), một tập hợp các chỉ dẫn cho các mẫu chung,
và một tập hợp các ví dụ. Bạn thậm chí có thể làm
cho tài liệu của bạn thành nguồn mở bằng việc yêu
cầu những đóng góp từ những người làm việc trong các
dự án của bạn.
Kết
luận
Hãy
tăng tốc việc tham gia cộng đồng của các lập
trình viên phần mềm tình nguyện bằng việc làm cho họ
cảm thấy được chào đón, trao cho họ các nhiệm vụ rõ
ràng, và thiết lập các cách thức hữu hình cho họ để
hoàn thành được. Quan trọng nhất, hãy cảm ơn những
người đóng góp khi họ giúp bạn. Dự án của bạn sẽ
thành công vì điều đó.
Loạt
bài của chúng tôi về Hãy làm quen với Nguồn Mở
(Getting
Started in Open Source)
chia sẻ các hướng dẫn, mẹo, và sự tư vấn - cộng
với, các dự án và các cộng đồng nguồn mở lớn cho
những ai mới làm quen với nguồn mở.
Community-driven
software development is becoming the new path to brand and project
success. You would be advised to pay attention to this surging trend:
With more than 27 million projects currently on GitHub,
the ever-increasing popularity of community-driven development is
evident.
So,
how do you go about engaging this global force of tech wizards?
As
co-founder of RethinkDB—an
open source, scalable JSON database designed for real time
Internet—I've got some thoughts on that. My team and I have created
the most
starred database on GitHub with thousands of volunteer
contributors. The open communication channel on GitHub has helped us
deliver the best solutions and create a product used by companies in
a variety of industries, including some Fortune 500 companies.
I've
come up with five concrete ways you too make your project successful
on GitHub. It's all about engaging the community.
1.
Prioritize your community
Open
source is more than a license and software development model; it's
also largely about the people. Encourage both users and maintainers
to collaborate to promote a surge in new ideas. You'll find that most
prominent projects incorporate a community of contributors with a
mailing list, GitHub project, and/or IRC/Slack channel.
2.
Welcome new contributors
Contributors
often feel intimidated and self-conscious when starting a new
project. Help them break out of their shell by offering a set of
contribution guidelines and using an issue tracker to highlight
troubleshooting that can be easily handled by new contributors.
Laying out the proper groundwork is vital to the success of your
project. For example, when we launched RethinkDB we also put out a
GitHub
issue etiquette guide to help users.
3.
Appreciate contributors' work
All
those who contribute to RethinkDB are co-creators and have ownership
over their work on each project. At RethinkDB, we recognize each
contributor's input in a variety of ways. Easy things to do that go a
long way are shout-outs, a kind note, or sending some swag, like a
T-shirt. Contributors help us build RethinkDB in a variety of ways,
whether it's submitting a pull request on GitHub or testing a new
feature or another task; each of them deserves gratitude from us.
4.
Use art to visualize your ideas
Art
has a powerful capability to communicate ideas, just like software.
Take advantage of graphic design to brand your projects. (We hired a
full-time developer to help us.) Consider creating a friendly mascot
(like the GitHub Octocat or RethinkDB Thinker) to help distinguish
your project for your community. In addition, use art to illustrate
and teach complex ideas and instructions. By incorporating art into
your project, you may also encourage artistic contributions from your
new contributors.
5.
Implement documentation to prevent problems
Fastidious
recording of your project process can avert potential issues and
confusion. Good documentation includes a FAQ section, a set of
instructions for common patterns, and a set of examples. You can even
make your documentation open source by asking for contributions from
those working on your projects.
Conclusion
Accelerate
engaging a community of volunteer software developers by making them
feel welcome, giving them clear tasks, and establishing tangible ways
for them to be completed. Most importantly, thank contributors when
they help you. Your project will flourish because of it.
Our
series about Getting
Started in Open Source shares tutorials, tips, and advice—plus,
great open source projects and communities for those new to open
source.
Dịch:
Lê Trung Nghĩa
Không có nhận xét nào:
Đăng nhận xét
Lưu ý: Chỉ thành viên của blog này mới được đăng nhận xét.