Fase saat ini:
Pengembangan dokumentasi. Lihat
linimasa.
Halaman ini berisi beberapa pertanyaan yang perlu dipertimbangkan saat membuat perjanjian dengan penulis teknis untuk Google Season Dokumen. Panduan ini tidak dimaksudkan sebagai saran hukum atau daftar lengkap semua poin yang perlu dipertimbangkan saat membuat perjanjian penulisan teknis untuk project open source. Bergantung pada kebutuhan organisasi atau project, Anda mungkin perlu berkonsultasi dengan penasihat hukum Anda sendiri sebelum memberikan orientasi kepada penulis teknis.
Ruang lingkup pekerjaan
- Buat daftar pekerjaan yang tercakup dalam perjanjian Anda. Jelaskan sespesifik mungkin. Misalnya, sebagai ganti "Dokumentasi API", buatlah daftar endpoint yang perlu didokumentasikan, dan informasi yang harus disertakan, seperti perintah curl contoh atau daftar parameter.
- Bagaimana cara mengetahui jika suatu konten telah 'selesai'?
- Hal-hal lain yang perlu dipertimbangkan:
- Siapa yang akan memiliki hak cipta atas karya tersebut? Di bawah lisensi apa lisensi tersebut akan dirilis (keduanya berbeda!)? Kredit apa yang akan diterima penulis teknis (sebutan di situs, tercantum sebagai kontributor, dll.)? Bagaimana jika konten tersebut perlu dilisensikan ulang di masa mendatang? Misalnya, jika Anda mengharapkan penulis teknis menandatangani Perjanjian Lisensi Kontributor project open source, Anda harus mengomunikasikannya.
- Jika Anda mengharapkan penulis teknis berpartisipasi dalam beberapa revisi izin, uraikan hal tersebut. Misalnya, Anda dapat menyatakan bahwa Anda mengharapkan draf pertama, lalu tahap kedua untuk mengatasi masalah teknis, lalu tahap akhir untuk pemeriksaan.
- Jika Anda mengharapkan penulis teknis mengirimkan konten dalam format tertentu, seperti Markdown, sertakan ini dalam perjanjian Anda.
- Apakah project Anda memiliki panduan penggunaan AI generatif untuk membuat dokumentasi atau kode? Pastikan panduan tersebut dibagikan kepada penulis teknis Anda.
Kompensasi
- Menyetujui penulis teknis tentang jadwal pembayaran yang terkait dengan tanggal dan hasil kerja yang pasti.
- Apakah Anda akan membayar uang di muka di awal pekerjaan?
- Apa yang terjadi jika pekerjaan tidak dapat digunakan atau diterima (karena prioritas project telah berubah atau karena peninjau berhenti, dll.)? Dapatkah Anda membayar 'biaya {i>kill<i}' untuk membantu mengimbangi 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 dapat dihubungi melalui panggilan video atau rapat?
- Saluran komunikasi apa yang akan Anda gunakan dan seperti apa waktu respons yang diharapkan? Misalnya, jika Anda mengharapkan penulis teknis membalas email (atau pesan di Slack) dalam satu hari, tuliskan hal tersebut secara eksplisit.
- Siapa dari project tersebut yang dapat dihubungi oleh penulis teknis untuk pertanyaan yang berbeda, seperti masalah pembayaran, perlu peninjauan, membuka pemblokiran masalah dengan alat atau saluran, atau penghalang lainnya?
- Apakah ada proses tertentu yang harus digunakan penulis untuk mengirimkan karya atau mendapatkan umpan balik 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
- Bagaimana Anda akan menyelesaikan ketidaksepakatan tentang kualitas karya penulis teknis? Siapa yang memiliki keputusan akhir?
- Bagaimana proses untuk melepaskan penulis teknis dari proyek? Misalnya, melewatkan tiga batas waktu berturut-turut, atau menyerahkan karya dengan kualitas yang tidak dapat diterima. Saat menerapkan proses, pertimbangkan untuk memberikan langkah eksplisit berikutnya ("Kami memperkirakan permintaan pull untuk draf pertama akan dikirimkan paling lambat Jumat depan" daripada "Kirimkan karya Anda sesegera mungkin.")
- Jika seorang penulis teknis perlu berhenti kuliah, bagaimana cara ia mengomunikasikan hal itu? Jika memungkinkan, apakah mereka harus memberikan pemberitahuan, membuat dokumen serah terima, atau melakukan panggilan serah terima?
- Jangan lupa untuk mempertimbangkan kewajiban proyek kepada penulis teknis. Misalnya, jika mentor project Anda berhenti dan tidak dapat diganti, atau jika peninjauan yang dijanjikan tidak dapat diselesaikan, pertimbangkan untuk membayar sebagian dana yang tersisa kepada penulis teknis meskipun project tidak dapat diselesaikan, untuk memberi kompensasi kepada penulis atas waktu mereka.
- Nyatakan secara eksplisit bahwa penulis teknis terikat oleh Kode Perilaku project, dan tertaut ke proses penegakan Kode Etik Anda. Anda dapat secara eksplisit menyatakan bahwa pelanggaran CoC akan mengakibatkan penghentian project dan penyitaan pembayaran untuk semua pekerjaan yang belum diselesaikan.