Pertanyaan umum (FAQ)

Fase saat ini:
Program Dokumen Musim 2019 selesai pada 6 Maret 2020. Lihat linimasa.

Umum

Apakah Season Dokumen merupakan program perekrutan?

Tidak. Jika Anda tertarik untuk bekerja di Google, kunjungi situs lowongan Google.

Apakah Season Dokumen dianggap sebagai magang, pekerjaan, atau bentuk pekerjaan apa pun?

Tidak. Season Dokumen adalah aktivitas yang dilakukan penulis teknis sebagai penulis teknis independen dan mereka dibayar tunjangan. Penulis teknis dapat memilih untuk tidak menerima gaji.

Mengapa saya harus ikut serta dalam Season Dokumen?

Tujuan Season Dokumen adalah untuk mendorong kolaborasi antara organisasi open source dan penulis teknis. Menurut kami program ini akan:

  • Memberi penulis teknis kesempatan untuk mendapatkan pengalaman berkontribusi pada project open source dan belajar tentang kode open source.
  • Berikan kesempatan pada proyek open source untuk melibatkan komunitas penulisan teknis, dan karenanya untuk meningkatkan kualitas dokumen open source mereka.
  • Meningkatkan kesadaran terhadap dokumen open source dan penulisan teknis.

Manfaat bagi organisasi open source:

  • Pengalaman bekerja dengan penulis teknis.
  • Dokumen yang lebih baik.
  • Potensi kolaborasi berkelanjutan dengan penulis teknis setelah Season Dokumen berakhir.
  • Proses yang lebih baik untuk mendokumentasikan project Anda.
  • Meningkatnya kesadaran terhadap dokumen open source di kalangan komunitas penulisan teknis.

Manfaat bagi penulis teknis:

  • Pengalaman berkontribusi pada proyek open source.
  • Pengalaman bekerja dengan dokumen yang berfokus pada developer dan dengan kode.
  • Kredit dan pengakuan atas pekerjaan yang dilakukan.
  • Sesuatu untuk ditambahkan ke resume Anda.
  • Potensi kolaborasi berkelanjutan dengan proyek open source setelah Musim Dokumen berakhir
  • Meningkatnya kesadaran di komunitas open source tentang nilai yang dapat diberikan penulis teknis.

Jenis proyek apa yang dapat ditangani oleh penulis teknis?

Berikut adalah beberapa ide:

  • Buat situs dokumentasi di sebuah platform yang akan diputuskan oleh penulis teknis dan mentor open source, serta publikasikan kumpulan dokumen dasar awal di situs tersebut. Contoh platform meliputi:

  • Faktorkan ulang dokumentasi project open source yang ada untuk memberikan pengalaman pengguna yang lebih baik atau arsitektur informasi yang lebih mudah diakses.

  • Tulis ikhtisar konseptual tentang, atau pengantar, produk atau fitur. Sering kali tim membuat dokumentasi teknis dari bawah ke atas, sehingga ada banyak detail, tetapi sulit untuk memahami produk secara keseluruhan. Penulis teknis dapat memperbaikinya.

  • Buat tutorial untuk kasus penggunaan penting.

  • Buat serangkaian panduan cara kerja yang terfokus untuk tugas tertentu.

  • Buat panduan kontributor yang berisi informasi dasar tentang cara memulai sebagai kontributor project open source, serta aturan apa pun seputar perjanjian lisensi, proses permintaan pull dan peninjauan, pembuatan project, dan sebagainya.

Apakah video bisa menjadi project yang memungkinkan untuk Season Dokumen?

Ya. Organisasi open source bebas untuk memublikasikan ide project dan memilih proposal project yang diajukan oleh penulis teknis. Jika video memenuhi persyaratan organisasi open source, Anda dapat mengirimkan video tersebut sebagai project Season Dokumen, dengan syarat video petunjuk teknisnya. Pastikan persyaratan video tercakup dengan baik dan perlu diketahui bahwa produksi video berkualitas tinggi membutuhkan waktu dan sumber daya.

Apakah organisasi bimbingan diwajibkan untuk menggunakan dokumen yang dihasilkan oleh penulis teknis?

Tidak. Meskipun kami berharap semua dokumentasi dan kode yang dihasilkan dari program ini akan selalu siap, kami tidak mewajibkan organisasi untuk menggunakan dokumen atau kode penulis teknis.

Di mana Season Dokumen tersedia?

Season Dokumen sepenuhnya tersedia secara online. Tidak ada persyaratan untuk bepergian sebagai bagian dari program ini.

Bagaimana cara mendapatkan informasi terbaru tentang Season Dokumen?

Kunjungi milis pengumuman di season-of-docs-announce untuk mengetahui info terbaru dan pengumuman terkait Season Dokumen. Bergabunglah dengan grup untuk menerima info terbaru melalui email.

Apa yang dapat saya lakukan untuk membantu menyebarkan informasi tentang Season Dokumen?

Anda dapat mengirim tweet tentang program, menulis postingan blog, memublikasikan video, atau menyelenggarakan pertemuan atau sesi informasi di area Anda. Kami memiliki beberapa contoh konten dan referensi yang dapat Anda gunakan untuk didistribusikan ke komunitas (organisasi, grup penulis, dan kontak lainnya).

Bagaimana cara menyelenggarakan atau menyelenggarakan pertemuan atau sesi informasi Season Dokumen?

Anda dapat menjadwalkan pertemuan kapan pun dan di tempat yang tepat bagi Anda. Tinjau aturan program dan gunakan contoh konten.

Dapatkah saya berpartisipasi dalam Season Dokumen sebagai mentor dan penulis teknis?

Tidak. Kami ingin memastikan bahwa setiap proyek dan penulis teknis mendapat perhatian yang cukup, dan kami merasa hal ini dapat menciptakan pengalaman buruk bagi mereka yang terlibat. Pilih apakah partisipasi sebagai mentor atau penulis teknis lebih menarik bagi Anda dan rencanakan untuk mendaftar dengan sesuai.

Apakah saya akan mendapatkan Kaus Musim Dokumen?

Ya. Peserta dalam proyek yang berhasil diselesaikan akan menerima Musiman Kaus Dokumen. Kaus tahun ini akan menjadi kaus program perdana.

Kapan kaus saya tiba?

Sebagai akibat dari situasi Covid-19, saat ini kami tidak memiliki perkiraan kapan Anda akan menerima kaus Anda. Google telah melibatkan vendor untuk memproduksi kaus dan menangani logistik pengirimannya ke seluruh dunia. Administrator program Google akan mengirimkan email yang berisi kode akses unik kepada Anda untuk memilih gaya/ukuran kaus dan memasukkan detail pengiriman setelah produksi dapat dilakukan. Produksi dan pengiriman kaus biasanya membutuhkan waktu beberapa minggu.

Bagaimana jika saya memiliki pertanyaan lain?

Pelajari panduan penulis teknis, panduan mentor, dan panduan administrator organisasi.

Jika setelah membaca semua dokumentasi Anda masih belum memiliki jawaban, pertimbangkan untuk mendiskusikan pertanyaan Anda dengan komunitas Season Dokumen di Slack atau daftar diskusi. Lihat informasi tentang saluran diskusi dan cara menghubungi kami.

Untuk penulis teknis

Kapan penulis teknis dapat mendaftar untuk Season Dokumen?

Fase pendaftaran penulis teknis berlangsung dari 29 Mei 2019 hingga 28 Juni 2019. Lihat linimasa program dan panduan penulis teknis.

Alat dan framework dokumentasi apa yang harus saya ketahui untuk berpartisipasi dalam Season Dokumen?

Framework dan alat dokumentasi yang akan Anda gunakan bergantung pada organisasi yang ingin Anda ajak bekerja sama. Bagian dari tujuan Season of Docs adalah untuk project open source guna membantu penulis teknis mempelajari lebih lanjut alat dan framework yang terlibat dalam mendokumentasikan produk open source. Oleh karena itu, biasanya Anda tidak harus memiliki pengetahuan mendetail tentang platform dokumentasi tertentu sebelum memulai project Season Dokumen.

Dengan demikian, sebagian besar organisasi open source menggunakan beberapa ragam Markdown atau bahasa markup lainnya untuk dokumentasi mereka. Sebaiknya cari tahu bahasa mana yang digunakan organisasi yang Anda pilih dan pahami sintaksisnya. Markdown adalah awal yang baik, karena file README GitHub menggunakan sedikit dari Markdown. Lihat panduan GitHub untuk Markup.

Cari tahu apakah organisasi pilihan Anda sudah menghosting dokumentasinya di situs, dan jika ya, platform apa yang mereka gunakan. Platform tersebut dapat berupa generator situs statis seperti Jekyll, Sphinx, atau Hugo, atau organisasi dapat menghosting dokumen mereka di Read the Docs atau GitHub Pages. Setelah Anda mengetahui platform yang digunakan organisasi, pelajari dan bereksperimenlah dengan bahasa dan framework yang relevan. Dengan begitu, Anda dapat memulai project open source dengan cepat, dan dapat memberikan saran yang bagus untuk project open source pilihan Anda.

Bahasa pemrograman apa yang harus saya ketahui untuk berpartisipasi dalam Season Dokumen?

Bergantung pada sifat project dokumentasi, Anda mungkin perlu memahami bahasa pemrograman. Ingatlah hal ini saat memilih dan mengusulkan project dokumentasi, dan konsultasikan tingkat pemahaman yang diperlukan dengan organisasi open source.

Bisakah saya mengirimkan lebih dari satu proposal proyek?

Ya, tetapi hanya satu proposal proyek per penulis teknis yang akan diterima. Lihat panduan untuk membuat aplikasi.

Dapatkah penulis teknis yang sudah mengerjakan proyek open source terus mengerjakannya sebagai bagian dari Season Dokumen?

Ya, tetapi Anda harus mencatat hubungan sebelumnya dengan project dalam proposal.

Bisakah kelompok mengirimkan proposal bersama untuk mengerjakan satu proyek?

Tidak, hanya orang yang dapat mengerjakan proyek tertentu.

Dapatkah saya menghubungi organisasi bimbingan secara langsung sebelum mengirimkan proposal ke Season Dokumen?

Ya, Anda dapat berkomunikasi langsung dengan organisasi open source yang ingin Anda ajak bekerja sama, sebelum mengirimkan permohonan untuk Season Dokumen. Mentor open source dapat membantu Anda menyempurnakan ide proyek.

Apa saja persyaratan kelayakan untuk berpartisipasi?

  • Anda harus berusia minimal 18 tahun saat mendaftar.
  • Anda harus memenuhi syarat untuk bekerja di negara tempat Anda akan tinggal selama program ini.
  • Anda harus tinggal di negara yang saat ini tidak diembargo oleh Amerika Serikat. Lihat aturan program dan Program Sanksi dan Informasi Negara dari Departemen Keuangan AS.

Apakah Anda akan membuat pengecualian untuk persyaratan kelayakan untuk saya?

Tidak. Kami tidak dapat membuat pengecualian jika Anda tidak memenuhi persyaratan kelayakan, tidak peduli seberapa berbakat atau tertarik Anda. Membuat pengecualian untuk Anda tidak adil bagi penulis teknis lain yang mendaftar untuk berpartisipasi dalam Musim Dokumen.

Formulir apa yang harus saya berikan?

Peserta yang diterima harus memberikan formulir pajak yang sesuai.

Apakah saya memerlukan pengalaman atau pelatihan sebelumnya sebagai penulis teknis?

Pengalaman penulisan teknis atau pelatihan sebelumnya lebih baik, tetapi tidak terlalu penting. Saat Anda mengirimkan proposal proyek, Anda dapat menggambarkan pengalaman dan/atau pelatihan Anda dalam penulisan teknis. Anda harus bisa memberikan beberapa bukti yang menunjukkan minat Anda pada dokumentasi teknis atau dokumentasi open source, termasuk contoh dokumentasi yang telah Anda tulis. Program Season of Docs bertujuan untuk bermitra dengan penulis teknis yang berpengalaman atau melatih penulis teknis dengan mentor open source, sehingga masing-masing dapat belajar dari yang lain. Organisasi open source akan mencari penulis teknis dengan tingkat pengalaman yang dibutuhkan organisasi, untuk memastikan keberhasilan penyelesaian project Season Dokumen mereka.

Apakah saya akan dibayar karena berpartisipasi dalam Season Dokumen?

Ya. Google akan memberikan tunjangan kepada penulis teknis tersebut yang berhasil menyelesaikan program. Anda dapat memilih untuk tidak menerima tunjangan. Lihat detail gaji penulis teknis.

Apakah saya akan dibayar meskipun organisasi tidak menggunakan dokumentasi atau kode saya?

Ya, asalkan project Anda lulus evaluasi akhir oleh mentor open source. Apakah project open source menggunakan dokumentasi atau kode yang dihasilkan, tidak akan memengaruhi pembayaran gaji penulis teknis.

Seperti apa proposal penulis teknis yang baik?

Proposal terbaik adalah dari penulis teknis yang meluangkan waktu untuk berinteraksi dan mendiskusikan ide-ide mereka dengan organisasi open source pilihan mereka sebelum mengirimkan aplikasi Season Dokumen. Lihat panduan untuk membuat aplikasi.

Berapa lama waktu yang diperlukan selama partisipasi dalam Musim Dokumen?

Jumlah waktu yang Anda habiskan tergantung pada sifat proyek yang telah Anda setujui dengan organisasi mentor. Persyaratan jumlah jam disengaja fleksibel, untuk memungkinkan berbagai jenis project dan gaya kerja yang berbeda.

Sebelum mengirimkan proposal project, Anda harus menilai project dan mendiskusikan perkiraan waktu dengan organisasi open source. Jika Anda kesulitan untuk menghabiskan jumlah waktu yang disepakati karena komitmen lain, ada opsi untuk menyelesaikan proyek dalam jangka waktu yang lebih lama, sambil tetap menerima gaji dan konfirmasi atas pekerjaan yang telah dilakukan. Saat Anda mengirimkan aplikasi Season of Dokumen, tentukan opsi untuk project yang berjalan lama.

Saya sedang mempelajari komunikasi teknis, tetapi belum memiliki pengalaman kerja. Apakah saya masih dapat berpartisipasi?

Ya. Saat mengirimkan proposal proyek, cantumkan universitas atau perguruan tinggi Anda di bagian untuk pengalaman kerja sebelumnya.

Saya adalah pelajar yang diterima di Amerika Serikat dengan visa F1. Bagaimana cara mendapatkan otorisasi untuk berpartisipasi?

Silakan hubungi kantor urusan pelajar internasional di sekolah Anda untuk mengetahui detail selengkapnya. Google tidak dapat memberikan jenis otorisasi CPT atau OPT apa pun kepada Anda.

Semua peserta yang diterima akan menerima email konfirmasi penerimaan. Kami tidak menawarkan surat yang disesuaikan.

Bagaimana Season Dokumen menggunakan informasi dari formulir permohonan saya?

Administrator program Google meneruskan beberapa informasi dari aplikasi Anda ke administrator organisasi open source pilihan Anda, sehingga organisasi tersebut dapat menilai proposal project Anda.

Jika project Anda diterima dalam program tersebut, Season of Docs akan memublikasikan detail project di situs.

Lihat deskripsi penggunaan data dalam panduan untuk formulir pendaftaran penulis teknis.

Untuk mentor open source dan administrator organisasi

Saya ingin mempelajari lebih lanjut cara berpartisipasi sebagai mentor di Season Dokumen. Di mana saya dapat menemukan informasi selengkapnya?

Baca panduan mentor dan aturan program untuk mengetahui informasi selengkapnya tentang cara menjadi mentor Season Dokumen.

Apa saja persyaratan kelayakan untuk organisasi bimbingan?

Agar memenuhi syarat untuk berpartisipasi sebagai organisasi bimbingan, Anda harus merupakan grup yang menjalankan project software gratis/open source aktif, seperti BRL-CAD. Project ini tidak perlu merupakan entitas yang didirikan secara hukum. Organisasi yang membimbing harus sudah membuat dan merilis software berdasarkan lisensi yang disetujui Inisiatif Open Source dan memiliki minimal dua kontributor untuk berperan sebagai administrator dan/atau mentor organisasi untuk keseluruhan program Season Dokumen agar dapat berpartisipasi dalam program ini.

Lihat juga persyaratan kelayakan yang dijelaskan dalam aturan program dan Program Sanksi dan Informasi Negara dari Departemen Keuangan AS.

Apakah organisasi menerima uang dengan berpartisipasi dalam Season Dokumen?

Organisasi yang bereputasi baik akan menerima tunjangan per penulis teknis yang diterima di akhir program. Ini terlepas dari apakah proyek penulis teknis berhasil atau tidak. Organisasi bebas menggunakan dana ini sesuai keinginan mereka.

Bagaimana administrator program Google mengalokasikan slot untuk proyek penulisan teknis?

Uji coba Season of Docs 2019 dibatasi hingga total maksimum 50 project penulisan teknis.

Sebagai panduan, kami memperkirakan akan menerima maksimal 2 project per organisasi, sehingga kami tidak akan menerima terlalu banyak project yang diterima. Namun, jika proses pemilihan gratis tidak mengisi semua slot, administrator program Google dapat mengalokasikan slot tambahan untuk beberapa organisasi.

Oleh karena itu, saat mengirimkan pilihan project penulisan teknis, Anda dapat memilih lebih dari 2 project. Pastikan Anda mencantumkan pilihan Anda sesuai urutan prioritas, dengan prioritas utama berada di bagian atas daftar.

Dalam komunikasi Anda dengan penulis teknis, Anda harus menjelaskan bahwa proyek tersebut tidak akan diterima sampai administrator program Google memublikasikan daftar proyek yang diterima di situs program.

Dapatkah saya berpartisipasi dalam Season Dokumen sebagai administrator organisasi sekaligus mentor?

Ya. Administrator organisasi juga bisa menjadi mentor. Anda tidak perlu mengisi formulir mentor terpisah. Saat mengisi formulir permohonan organisasi, atau formulir administrator alternatif, Anda harus menggunakan opsi di formulir tersebut untuk menunjukkan bahwa Anda juga bertindak sebagai mentor.

Dapatkah saya berpartisipasi sebagai administrator organisasi atau mentor di Season Dokumen dan Google Summer of Code?

Ya. Season Dokumen dan Google Summer of Code adalah program terpisah. Tidak masalah jika Anda memiliki bandwidth untuk berpartisipasi dalam kedua program tersebut.

Dapatkah saya berpartisipasi sebagai administrator organisasi atau mentor di Season Dokumen dan Google Code-in?

Ya. Season Dokumen dan Google Code-in adalah program terpisah. Tidak masalah jika Anda memiliki bandwidth untuk berpartisipasi dalam kedua program tersebut.

Data yang diarsipkan

Bagaimana cara menghapus informasi saya dari arsip Season Dokumen?

Hubungi kami agar informasi Anda dihapus.