Fase saat ini:
Studi kasus dipublikasikan. Lihat
linimasa.
Halaman ini berisi beberapa pertanyaan yang perlu dipertimbangkan saat membuat perjanjian dengan penulis teknis untuk Google Season of Docs. Panduan ini tidak dimaksudkan sebagai saran hukum atau daftar lengkap semua kemungkinan poin yang perlu dipertimbangkan saat membuat perjanjian tulisan teknis untuk project open source. Bergantung pada kebutuhan organisasi atau project Anda, sebaiknya konsultasikan dengan penasihat hukum Anda sendiri sebelum melakukan orientasi penulis teknis.
Ruang lingkup pekerjaan
- Buat daftar karya yang tercakup dalam perjanjian Anda. Jelaskan sespesifik mungkin. Misalnya, alih-alih "Dokumentasi API", buat daftar endpoint yang perlu didokumentasikan, dan informasi yang harus disertakan, seperti contoh perintah curl atau daftar parameter.
- Bagaimana cara mengetahui apakah sebuah konten sudah 'selesai'?
- Hal lain yang perlu dipertimbangkan:
- Siapa yang akan memiliki hak cipta atas karya tersebut? Lisensi apa yang akan digunakan untuk merilisnya (ini berbeda!)? Apa kredit yang akan diterima penulis teknis (disebutkan di situs, tercantum sebagai kontributor, dll.)? Bagaimana jika konten perlu dilisensikan ulang pada masa mendatang? Misalnya, jika Anda mengharapkan penulis teknis untuk menandatangani Perjanjian Lisensi Kontributor project open source Anda, Anda harus menyampaikannya.
- Jika Anda mengharapkan penulis teknis untuk berpartisipasi dalam beberapa tahap revisi, jelaskan hal tersebut. Misalnya, Anda dapat menyatakan bahwa Anda mengharapkan draf pertama, lalu draf kedua untuk mengatasi masalah teknis, lalu draf akhir untuk penyuntingan.
- Jika Anda mengharapkan penulis teknis untuk mengirimkan konten dalam format tertentu, seperti Markdown, sertakan hal ini dalam perjanjian Anda.
- Apakah project Anda memiliki pedoman untuk penggunaan AI generatif dalam membuat dokumentasi atau kode? Pastikan pedoman tersebut dibagikan kepada penulis teknis Anda.
Kompensasi
- Menyetujui jadwal pembayaran dengan penulis teknis yang terkait dengan tanggal dan hasil kerja yang pasti.
- Apakah Anda akan membayar jumlah di muka di awal pekerjaan?
- Apa yang terjadi jika pekerjaan tidak dapat digunakan atau diterima (karena prioritas project telah berubah atau karena peninjau mengundurkan diri, dll.)? Dapatkah Anda membayar 'biaya pembatalan' untuk membantu mengganti waktu yang dihabiskan oleh penulis teknis?
- Siapa yang akan bertanggung jawab atas biaya konversi mata uang yang terkait dengan metode pembayaran yang dipilih?
Komunikasi
- Apakah Anda mengharapkan penulis teknis tersedia untuk panggilan video atau rapat?
- Saluran komunikasi apa yang akan Anda gunakan dan berapa waktu respons yang diharapkan? Misalnya, jika Anda mengharapkan penulis teknis untuk merespons email (atau pesan di Slack) dalam sehari, buatlah hal itu eksplisit.
- Siapa dari project yang dapat dihubungi penulis teknis untuk berbagai pertanyaan, seperti masalah pembayaran, kebutuhan peninjauan, masalah pemblokiran alat atau saluran, atau pemblokir lainnya?
- Apakah ada proses tertentu yang harus digunakan penulis untuk mengirimkan karyanya atau mendapatkan masukan atau ulasan?
Alat
- Alat (atau versi alat) apa yang perlu digunakan penulis teknis untuk membuat karyanya?
- Siapa yang bertanggung jawab untuk membantu penulis teknis menyiapkan, mendapatkan akses, atau mendapatkan izin?
Menyelesaikan perbedaan pendapat
- Bagaimana Anda akan menyelesaikan perbedaan pendapat tentang kualitas pekerjaan penulis teknis? Siapa yang memiliki keputusan akhir?
- Bagaimana proses untuk melepaskan penulis teknis dari project? Misalnya, melewatkan tiga batas waktu berturut-turut, atau menyerahkan tugas dengan kualitas yang tidak dapat diterima. Saat menerapkan proses, pertimbangkan untuk memberikan langkah berikutnya yang eksplisit ("Kami mengharapkan permintaan pull untuk draf pertama dikirimkan paling lambat Jumat depan", bukan "Kirimkan pekerjaan Anda sesegera mungkin").
- Jika penulis teknis harus keluar, bagaimana cara mereka menyampaikannya? Jika memungkinkan, haruskah mereka memberikan pemberitahuan, membuat dokumen pengalihan, atau melakukan panggilan pengalihan?
- Jangan lupa untuk mempertimbangkan kewajiban project kepada penulis teknis. Misalnya, jika mentor project Anda mengundurkan diri dan tidak dapat diganti, atau jika ulasan yang dijanjikan tidak dapat diselesaikan, pertimbangkan untuk membayar sebagian dana yang tersisa kepada penulis teknis meskipun project tidak dapat selesai, untuk memberikan kompensasi kepada penulis atas waktunya.
- Nyatakan secara eksplisit bahwa penulis teknis terikat dengan Kode Perilaku project, dan tautkan ke proses penegakan Kode Perilaku Anda. Sebaiknya Anda menjelaskan secara eksplisit bahwa pelanggaran KoC akan mengakibatkan penghentian project dan pembatalan pembayaran untuk pekerjaan yang belum selesai.