Ditulis oleh Jed Hartman, Technical Writer

Anda sekarang bisa menggunakan panduan gaya dokumentasi developer kami untuk project dokumentasi open source.

Selama beberapa tahun, para penulis teknis kami di Google telah menggunakan panduan gaya editorial khusus-internal untuk sebagian besar dokumentasi developer kami. Untuk lebih mendukung kontributor eksternal terhadap project open source kami, seperti Kubernetes, AMP, atau Dart, dan agar lebih konsisten untuk semua dokumentasi developer, kami sekarang mempublikasikan panduan gaya tersebut.

Bila Anda memberikan kontribusi dokumentasi dalam project seperti itu, Anda sekarang memiliki akses langsung ke panduan mengenai pertimbangan suara, nada, pilihan kata, dan gaya lainnya. Ini bisa diterapkan untuk masalah umum, seperti pengingat untuk menggunakan orang kedua, present tense, suara aktif, dan koma serial; ini juga sangat cocok untuk memeriksa masalah yang sangat spesifik, seperti apakah akan menulis "apl" atau "aplikasi" bila Anda ingin konsisten dengan gaya Google Developers.

Panduan gaya adalah dokumen referensi, jadi sebagai ganti membacanya secara linear, Anda bisa menggunakannya sebagai panduan referensi sesuai kebutuhan. Untuk masalah tanda baca, tata bahasa, dan pemformatan, Anda bisa melakukan penelusuran di halaman untuk menemukan item seperti "Commas," "Lists," dan "Link text" di navigasi kiri. Untuk istilah dan frasa tertentu, Anda bisa melihat daftar kata.

Perhatikan halaman catatan rilis dari panduan untuk update dan development, dan silakan kirim komentar dan saran Anda melalui link Send Feedback di setiap halaman panduan—kami ingin mendengar dari Anda selagi kami terus mengembangkan panduan gaya.