Kontribusi non-kode terhadap open source

 (github.com/readme)
10 poin oleh GN⁺ 2024-02-15 | 6 komentar | Bagikan ke WhatsApp

Kontribusi non-kode adalah kunci keberhasilan open source

  • Sarah Rainsberger, seorang guru matematika, awalnya tidak berniat menjadi kontributor open source secara sukarela, tetapi mulai mempelajari JavaScript dan pengembangan web saat membangun ulang situs web paduan suaranya.
  • Saat menggunakan Astro, framework frontend, ia akhirnya menyumbangkan potongan kode kecil berupa file konfigurasi ke proyek tersebut, lalu ikut terlibat dalam komunitas dan mengambil peran mendukung pengguna baru Astro.
  • Kini Rainsberger adalah bagian dari kelompok core maintainer Astro, tetapi tidak banyak terlibat langsung dengan codebase dan lebih berfokus pada dokumentasi sambil membantu orang lain mempelajari Astro.

Pekerjaan non-kode penting dalam proyek open source

  • Selain menulis kode, proyek open source juga memerlukan dokumentasi, lokalisasi, pemasaran, desain grafis, pengujian, manajemen komunitas, dan manajemen rilis.
  • Pentingnya kontribusi non-kode sangat besar; semakin kompleks sebuah proyek, semakin banyak dokumentasi, tutorial, dan dukungan yang dibutuhkan agar kodenya benar-benar berguna.
  • Desain grafis, branding, dan outreach berfungsi sebagai sinyal yang menunjukkan kesehatan dan keseriusan sebuah proyek, sehingga proyek atau perusahaan lain dapat menggunakannya sebagai dependency.

Alasan mulai berkontribusi non-kode

  • Kontribusi non-kode memberi kesempatan membangun portofolio bagi orang yang tertarik pada peran tanpa pemrograman, seperti technical communication, desain grafis, dan desain pengalaman pengguna.
  • Programmer juga mendapat manfaat dengan mengasah kemampuan menulis dan komunikasi, yang dapat membantu saat beralih ke peran seperti developer relations atau product management.
  • Proyek open source menyediakan peluang bagi orang di semua tingkat keterampilan untuk ikut berpartisipasi, sementara tanpa pemahaman mendalam tentang proyek, sulit memberikan kontribusi kode yang benar-benar bermakna.

Mencari kontributor non-kode dan menunjukkan apresiasi

  • Bagi maintainer, cara terbaik menemukan kontributor adalah dengan meminta tugas tertentu; membangun komunitas serta membuat issue yang diberi label "butuh bantuan" dan "isu pertama yang bagus" juga sangat membantu.
  • Mentorship adalah salah satu cara terbaik untuk mengantarkan kontributor menuju keberhasilan, dan menghargai serta mengakui kontributor non-kode membantu memotivasi kontributor saat ini sekaligus menarik kontributor baru.

Opini GN⁺

  • Penting untuk menyadari bahwa keberhasilan proyek open source membutuhkan beragam kontribusi yang melampaui sekadar menulis kode. Ini merupakan elemen penting bagi keberlanjutan dan pertumbuhan proyek.
  • Kontribusi non-kode membuka peluang bagi orang non-teknis untuk ikut berpartisipasi dalam open source, sekaligus membantu mereka mengembangkan kemampuan teknis.
  • Tulisan ini dapat menginspirasi orang yang tertarik pada komunitas open source dan membantu mereka menemukan cara memanfaatkan keterampilannya untuk berkontribusi pada komunitas.

Bacaan terkait

6 komentar

 
secret3056 2024-02-15

Ini cerita yang agak berbeda, tetapi belum lama ini seseorang mengunggah tutorial tentang cara membuat PR ke file README Express.js sehingga muncul ratusan PR tidak bermakna.

Pull requests · expressjs/express
 
mdisprgm 2024-02-16

Merepotkan.. hiks
 
edunga1 2024-02-15

PR-nya lebih dari 100, gila juga wkwk
 
sagee 2024-02-15

Saya sempat sedikit bingung soal bagaimana berpartisipasi dengan "barcode"... haha
Dokumentasi yang sangat rinci, kalau dipikir-pikir, mungkin juga bisa menjadi pedang bermata dua.
Bisa juga muncul kasus ketika dokumentasi dan screenshot jadi terlalu detail sampai sulit ditangani oleh developer, sehingga mereka tidak percaya diri untuk memperbarui dokumentasi dan akhirnya menyerah mengembangkan perbaikannya..
 
cosine20 2024-02-16

(Ini kode “non-”)
 
GN⁺ 2024-02-15
Komentar Hacker News

  • Sebagai penulis/pengelola library kecil, saya bisa memastikan bahwa tanpa kontribusi dari luar, manualnya tidak akan sebaik sekarang. Manual sangat berkontribusi pada kegunaan proyek.

    • Sebagai pengguna baru libcurl, berkat tutorial dan dokumentasi API, saya bisa dengan cepat mengimplementasikan upload FTP dan menyesuaikannya dengan kasus penggunaan tertentu.
    • Melalui dokumentasi, saya bisa mengetahui kurangnya thread safety pada versi lama dan memperingatkan tim untuk melakukan pembaruan.
    • Dokumentasi sama pentingnya dengan kode dan test suite.

  • Harapan terhadap proyek open source:

    • banyak screenshot
    • README.md yang sangat panjang dan terperinci
    • tutorial, dokumentasi referensi, dokumen desain, diagram arsitektur
    • dokumen model mental yang menjelaskan cara berpikir penulis

  • Dalam open source, dokumentasi, aset, dan semacamnya memang penting, tetapi juga bisa memberi terlalu banyak kuasa kepada non-developer hingga merusak proyek.

    • Ini bisa merugikan stabilitas, fungsionalitas, dan adopsi, misalnya dengan mendesain ulang UX di setiap rilis.
    • Ini juga bisa menarik orang yang sangat tertarik pada politik, dan memudahkan terjadinya 'bikeshedding' di area yang dianggap bisa dilakukan siapa saja.

  • Untuk membangun komunitas, ada baiknya menggunakan platform chat seperti Discord, Gitter, dan Slack.

    • Ini membuat orang tidak ragu untuk bertanya di repositori.
    • Bertanya di GitHub atau membuat pull request untuk menyelesaikan masalah sering kali terasa tidak ada gunanya.
    • Di antara para pembuat proyek GitHub, sikap "saya sudah membuka kodenya, jadi saya tidak berutang apa pun lebih dari itu" tersebar luas.

  • Berdasarkan pengalaman beraktivitas di komunitas WordPress, saya merasa dokumentasi awal dan dokumentasi kuat di Codex sangat berkontribusi pada pertumbuhan WordPress.

    • Pada masa ketika Joomla, Drupal, dan WordPress memiliki basis instalasi yang mirip, WordPress lebih mudah mulai digunakan berkat dokumentasinya yang kaya.

  • Harapan terbesar terhadap proyek open source adalah orang-orang benar-benar menggunakannya dan meninggalkan catatan tentang penggunaannya dalam bentuk apa pun.

    • Meninggalkan pesan di kanal Discord proyek, tweet, pesan singkat, screenshot, gist, repositori GitHub publik, video YouTube, atau TikTok, semuanya adalah kontribusi yang sangat bernilai bagi proyek.

  • Saya tidak yakin kontribusi non-code adalah rahasia kesuksesan sebuah proyek, tetapi saya setuju bahwa itu sangat penting.

    • Sebagai contoh, Eclipse Foundation mengingatkan penggunanya bahwa bug report juga merupakan kontribusi yang bernilai.

  • Dalam proses memulai proyek open source, ada perkiraan bahwa akan ada 10 kali lebih banyak engineer yang menggunakan perangkat lunak dibanding engineer yang benar-benar menulis kodenya.

    • Pengguna harus bisa berkontribusi dengan memperbaiki dokumentasi.
    • Saat menggunakan static site generator seperti Hugo untuk membuat dokumentasi (manual pengguna), perlu ada cara agar pengguna bisa mengirim perbaikan/pembaruan dokumentasi tanpa harus membuat issue di GitHub.

  • Jika orang nonteknis bisa memahami proyek dan menemukan nilainya, itu adalah indikator yang baik bahwa proyek tersebut akan sukses.

  • Dokumentasi menjadi penting saat produk berpindah dari tahap digunakan oleh para penggemar ketika belum dikenal, ke tahap mencari lebih banyak pengguna.

    • Tanpa dokumentasi yang baik, sulit melewati tahap ini.
    • Ini mengingatkan saya bahwa saya harus menulis panduan pengguna untuk Neural Amp Modeller.