Teknik yazar seçme

Mevcut aşama:
Belge geliştirme Zaman çizelgesini inceleyin.

Bu sayfada, açık kaynak kuruluşlara yönelik olarak, Google Dokümanlar Sezonu proje teklifleri için doğru teknik yazarı nasıl değerlendirecekleri ve seçecekleri ile ilgili ipuçları yer almaktadır.

Giriş

Açık Kaynak Kuruluşların, teklif ettikleri projeler üzerinde çalışması için bir teknik yazar istihdam etmesi gerekir. Kuruluşlar, kendi teknik yazarlarını kendileri oluşturmalıdır. Google Dokümanlar Sezonu'na katılan kuruluşlarla çalışmak isteyen teknik yazarlar, Google Dokümanlar'ın Sezonu GitHub deposunda ve Write the Docs Slack'teki #season-of-docs kanalında bulunabilir.

Süreci başlatma

Google Dokümanlar Sezonu'na katılmak isteyebileceğinizi düşündüğünüz an teknik bir yazar bulma sürecine hemen başlamanız önerilir.

Teknik yazar değerlendirmesi

Teknik yazma becerilerini ve deneyimlerini değerlendirebilmek için ilgilendiğiniz teknik yazarlardan daha önce geliştirilmiş belge örnekleri istemeniz önerilir.

Teknik yazma becerileri ve deneyimi

  • Teknik yazarın önceki deneyimlerini inceleyin. İdeal senaryo, teknik yazarın yazılım sektörü için teknik belge yazma konusunda belli bir deneyime sahip olması gerekir. Google Dokümanlar Sezonunun hedeflerinden biri, teknik yazarlara geliştirici odaklı ürünlere dahil olma fırsatı vermektir. Bu nedenle, projeniz geliştirici kitlesine odaklansa bile yazarın API, SDK veya diğer geliştirici platformları konusunda deneyimli olması gerekli değildir.

  • Dil ve iletişim becerilerine odaklanın. Teknik yazarın önceki çalışmalarını bu açıdan değerlendirin. En önemlisi: Kişinin ne yazdığını anlayabiliyor musunuz? Teknik yazarın eserinin dilini ayrıntılı bir şekilde gözden geçirmek istiyorsanız, noktalama ve ifade kullanımında tutarlılık, doğru yazım ve açık bir dil kullanın. İfade basit mi yoksa karmaşık mı? Cümleler kısa mı yoksa takip edilmesi zor hale gelene kadar devam ediyor mu?

  • Belge tasarımına ve düzenine dikkat edin. Doküman örneklerinin genel düzenini kontrol edin. Mantıklı bir tasarım mı yapıldı? Dokümanda veya belge grubunda kolayca gezinebiliyor musunuz? İçerik tekrarlanıyor mu yoksa bariz boşluklar mı var?

Teknik yazar işe almak

Kuruluşların, 22 Mayıs 2024 saat 18:00'e (UTC) kadar teknik yazar tutması ve aşağıda bağlantısı verilen Teknik Yazar İşe Alma Formu'nu doldurması gerekir.

Teknik yazar işe alma aşaması tamamlandı.

İşe alımdan önce teknik yazarla ücret ve ödeme planı hakkında görüşmeyi unutmayın. Kuruluşların, proje başlangıcında yapılacak ödemeler de dahil olmak üzere, projenin ara hedeflerine göre teknik yazarlarla bir ödeme planı oluşturmalarını öneririz. Program boyunca yalnızca iki kez gerçekleştirilecek ve ödeme planı oluşturulurken uygulanan ödeme tarihlerini göz önünde bulundurun.

Not: 22 Mayıs 2024 saat 18:00'e (UTC) kadar teknik yazar işe almamış ve Teknik Yazar İşe Alma Formu'nu gönderen kuruluşlar ilk ödeme tarihinde finansman almayacaktır.