Fase saat ini:
Pengembangan dokumentasi. Lihat
linimasa.
Panduan ini ditujukan bagi administrator organisasi yang mengajukan permohonan atau berpartisipasi dalam program Google Season of Docs.
Haruskah organisasi Anda berpartisipasi dalam program Google Season of Docs?
Gunakan pertanyaan ini untuk membantu Anda memahami apakah project atau organisasi open source Anda harus berpartisipasi dalam Google Season Dokumen.
Apakah organisasi atau proyek Anda:
- Percayakah bahwa dokumentasi baru atau yang diperbarui akan membantu mencapai suatu tujuan atau memecahkan masalah dalam proyek atau komunitas Anda?
- Memiliki pemahaman awal tentang atau hipotesis tentang bagaimana Anda akan mengukur keberhasilan proyek dokumentasi?
- Apakah anggota masyarakat bersedia untuk membantu merekrut, mengevaluasi, dan mengorientasikan seorang penulis teknis, dan siapa yang akan bersedia untuk menjawab pertanyaan dan memberikan dukungan lain selama proyek berlangsung (6-8 bulan, termasuk periode pendaftaran)?
- Apakah ada anggota komunitas yang bersedia berperan sebagai administrator organisasi dan berkoordinasi dalam membuat aplikasi, menjawab pertanyaan dari administrator program, dan mengirim evaluasi bulanan serta evaluasi akhir dan studi kasus? Administrator organisasi juga harus bersedia menjawab survei tindak lanjut setelah penyelesaian program Google Season Dokumen.
Organisasi Anda juga harus memenuhi persyaratan kelayakan program, termasuk dapat membuat akun Open Collective.
Proses pengajuan permohonan organisasi
Fase eksplorasi
Meskipun pendaftaran Google Season Dokumen dibuka pada 22 Februari 2024, sebaiknya organisasi meluangkan waktu untuk menyelesaikan langkah-langkah pada fase Eksplorasi sebelum mengirimkan permohonan mereka.
- Membuat halaman proposal proyek. Halaman proposal berisi daftar kebutuhan utama, sasaran, atau masalah, kemungkinan solusi dokumentasi, dan metrik yang memungkinkan. Halaman ini harus bersifat publik, serta memungkinkan kontribusi dan diskusi dari komunitas. Sertakan informasi untuk penulis teknis yang ingin berpartisipasi—di mana mereka harus mengajukan pertanyaan, menyatakan minat, atau mempelajari project Anda lebih lanjut? Sebaiknya tambahkan alamat email untuk menghubungi organisasi open source Anda terkait Google Season Dokumen. Namun, kami sangat menyarankan untuk tidak menggunakan alamat email pribadi sebagai alamat email untuk menghubungi organisasi open source Anda. (Lihat daftar ide project untuk mengetahui contohnya.)
- Publikasikan halaman proposal Anda di saluran komunitas dan tambahkan organisasi Anda ke daftar organisasi yang tertarik di repositori GitHub Google Season Dokumen. Anda mungkin juga ingin membagikan link di channel #season-of-docs di bagian Menulis Dokumen Slack. Halaman promosi dan pers mencakup logo dan konten lain yang dapat Anda gunakan ketika membahas Google Season Dokumen.
- Untuk setiap ide dokumentasi, pertimbangkan pengalaman dan kualifikasi apa yang dibutuhkan penulis teknis agar dapat berhasil bekerja sama dengan komunitas dan organisasi Anda. Keterampilan apa yang dapat dibutuhkan komunitas Anda untuk membantu pengembangan penulis teknis (misalnya, menggunakan GitHub atau toolchain dokumen)? (Lihat panduan untuk bekerja sama dengan penulis teknis.
- Mintalah sukarelawan untuk membantu menjawab pertanyaan dari penulis teknis yang tertarik.
- Mulailah meninjau setiap pernyataan minat yang dikirimkan dari penulis teknis yang tertarik untuk bekerja dengan proyek Anda.
Fase pendaftaran
- Pilih ide yang paling menjanjikan dari halaman proposal. Setiap organisasi
hanya dapat mengirimkan satu proposal. Beberapa hal yang perlu dipertimbangkan:
- Ide mana yang paling banyak diminati dari penulis teknis?
- Ide mana yang akan membantu memecahkan masalah terbesar proyek Anda? Sebaiknya pilih ide yang lebih berisiko yang akan memiliki dampak lebih besar daripada ide project dokumentasi yang kemungkinan besar akan diselesaikan tetapi tidak akan membuat perbedaan signifikan pada project Anda.
- Apakah ide ini membutuhkan partisipasi dari anggota tertentu dari komunitas Anda? Apakah mereka memiliki waktu untuk berpartisipasi?
Buat proposal menggunakan template proposal. Pastikan Anda memahami dan menyertakan:
- Masalah yang ingin Anda atasi
- Cakupan dokumentasi yang ingin Anda tingkatkan atau buat
- Bagaimana Anda akan mengukur keberhasilan dokumentasi
Proposal juga harus menyertakan anggaran. Proposal yang tidak lengkap tidak dapat dipertimbangkan.
Kirimkan Formulir Permohonan sebelum batas waktu pendaftaran 2 April 2024 pukul 18.00 UTC. Proposal yang disetujui akan diumumkan pada 10 April 2024.
Pengembangan dan pelaporan proyek
{i>Kickoff<i} (permulaan) proyek
- Jika organisasi Anda telah memilih penulis atau penulis teknis untuk proyek Anda, lakukan {i>kickoff meeting<i} dengan penulis teknis Anda. Anda harus berkolaborasi dengan penulis teknis untuk membuat jadwal pekerjaan dan {i>check-in<i} rutin.
- Jika Anda menerima beberapa pernyataan minat dari penulis teknis yang tertarik, buat pengumuman publik tentang pilihan penulis teknis Anda atau beri tahu pelamar tentang keputusan Anda.
Memberikan pembayaran
- Mulai 11 Juni 2024, Google Season of Docs akan menyetorkan 40% dana hibah ke setiap akun Open Collective milik organisasi setelah mereka menyewa penulis teknis. Sebaiknya organisasi membuat jadwal pembayaran dengan penulis teknis berdasarkan pencapaian project, termasuk pembayaran saat memulai project.
- 60% sisanya akan disetorkan ke akun Open Collective dari organisasi yang menyelesaikan dan mengirimkan evaluasi akhir serta studi kasus, mulai 13 Desember 2024. Semua project yang berhasil akan mulai menerima pembayaran akhir pada 13 Desember 2024
- Lihat panduan pembayaran untuk mengetahui informasi selengkapnya tentang cara membuat akun Open Collective.
Pelaporan status project
- Administrator organisasi harus mengisi laporan status bulanan dalam waktu satu minggu setelah menerima link ke formulir laporan status (link akan dikirim melalui email, jadi periksa folder spam jika Anda belum melihatnya).
Evaluasi akhir proyek dan studi kasus
Organisasi harus menyelesaikan dan mengirimkan evaluasi akhir project dan studi kasus sebelum 10 Desember 2024 pukul 18.00 UTC untuk menerima sisa dana hibah.
Evaluasi akhir
Formulir evaluasi akhir akan tersedia untuk administrator organisasi paling tidak satu bulan sebelum 10 Desember 2024 pukul 18.00 UTC.
Studi kasus
Studi kasus Google Season of Dokumen adalah hasil utama partisipasi organisasi Anda dalam Google Season Dokumen. Menyimpan catatan mingguan pembaruan proyek akan membantu Anda membuat studi kasus. Setiap minggu, catat progres project (termasuk link ke permintaan pull, masalah, atau percakapan, jika berguna), apa yang berjalan dengan baik (atau tidak dengan baik), hal-hal yang telah Anda pelajari, dan pertanyaan yang diajukan.
Baca artikel tentang membuat studi kasus untuk mengetahui informasi tambahan dan pastikan untuk mengikuti template studi kasus kami untuk membuat studi kasus Anda. Anda akan mengirimkan studi kasus sebagai link di formulir evaluasi akhir.
Studi kasus Anda akan dipublikasikan di situs Google Season of Docs, jadi ingatlah hal tersebut ketika menyertakan informasi tentang project Anda.
Organisasi yang diterima wajib berpartisipasi dalam setidaknya tiga survei tindak lanjut untuk membantu melacak keberhasilan proyek Google Season Dokumen dari waktu ke waktu.
Formulir
| Formulir | Link | Batas waktu |
|---|---|---|
| Permohonan organisasi | Pendaftaran organisasi kini telah ditutup. Ikuti milis pengumuman di season-of-docs-announce untuk mengikuti perkembangan informasi. |
2 April 2024 pukul 18.00 UTC |
| Informasi pembayaran organisasi | 14 Mei 2024 pukul 18.00 UTC | |
| Bukti perekrutan penulis teknis | 22 Mei 2024 pukul 18.00 UTC | |
| Evaluasi bulanan | Formulir tersedia selama fase evaluasi project (5 Juni 2024). |
Lihat linimasa |
| Evaluasi proyek akhir dan studi kasus | Formulir tersedia selama evaluasi project akhir dan fase studi kasus (22 November 2024 - 10 Desember 2024). |
10 Desember 2024 pukul 18.00 UTC |
| Survei lanjutan | Formulir tersedia selama tahap survei tindak lanjut (1 Mei 2025). |
Lihat linimasa |
Informasi terkait
- Tinjau linimasa Google Season Dokumen.