Teknik yazar seçme

Mevcut aşama:
Sonuçlar açıklandı. Zaman çizelgesine bakın.

Bu sayfada, açık kaynak kuruluşlarının Google Dokümanlar Sezonu proje teklifi için doğru teknik yazarı değerlendirme ve seçme konusunda ipuçları bulunmaktadır.

Giriş

Açık Kaynak Kuruluşları, önerdikleri proje üzerinde çalışmak için teknik bir yazar tutmalıdır. Kuruluşlar kendi teknik yazarlarını sağlamalıdır. Google Dokümanlar Sezonu'na katılan kuruluşlarla çalışmak isteyen teknik yazarları Google Dokümanlar Sezonu GitHub deposunda ve Write the Docs Slack'teki #season-of-docs kanalında bulabilirsiniz.

Sürecin başlatılması

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

Teknik yazarları değerlendirme

Teknik yazarların teknik yazma becerilerini ve deneyimlerini değerlendirmeye odaklanabilmek için, daha önce geliştirdikleri dokümanlar için örnekler istemeniz önerilir.

Teknik yazı yazma becerileri ve deneyimi

  • Teknik yazarın önceki deneyimini inceleyin. İdeal olarak teknik yazar, yazılım sektörü için teknik dokümanlar yazma konusunda daha önce deneyim sahibi olmalıdır. Google Belge Sezonu'nun hedeflerinden biri, teknik yazarlara geliştirici odaklı ürünlerle ilgilenme fırsatı sunmaktır. Bu nedenle, projeniz geliştirici kitlesine odaklansa bile yazarın API'ler, SDK'lar veya diğer geliştirici platformları konusunda deneyimli olması gerekmez.

  • Dil ve iletişim becerilerine odaklanın. Teknik yazarın önceki çalışmalarını bu açıdan değerlendirin. En önemlisi: Kullanıcının yazdıklarını anlayabiliyor musunuz? Teknik yazarın çalışmasının dilini ayrıntılı olarak incelemek istiyorsanız noktalama işaretleri ve ifade biçimi açısından tutarlılık, doğru yazım ve net bir dil olup olmadığına bakın. İfade basit veya karmaşık mı? Cümleler kısa mı yoksa okunması zor olana kadar mı devam ediyor?

  • Doküman tasarımına ve düzenine dikkat edin. Belge örneklerinin genel düzenini kontrol edin. Tasarım mantıklı mı? Dokümanda veya doküman grubunda kolayca gezinebiliyor musunuz? İçerikte kopya içerik var mı veya belirgin boşluklar var mı?

Teknik yazar bulma

Kuruluşlar 10 Mayıs 2023 saat 18:00 (UTC) tarihine kadar bir teknik yazar işe alıp aşağıda bağlantısı verilen Teknik Yazar işe alma belgesini doldurmalıdır.

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

Teknik yazarla işe almadan önce ücret ve ödeme planı hakkında görüşün. Kurumların proje başlangıcında ödeme yapılması da dahil olmak üzere projenin ara hedeflerine göre teknik yazarlarla bir ödeme planı oluşturmasını öneririz. Ödeme tarihlerini (program boyunca yalnızca iki kez gerçekleşir) ve tutarları ödeme planı oluştururken göz önünde bulundurun.

Not: Teknik yazar istihdam etmeyen ve 10 Mayıs 2023, 18:00 (UTC) tarihine kadar Teknik Yazar İstihdamı Kanıtı Formu'nu göndermeyen kuruluşlar ilk ödeme tarihinde para almaz.