Teknik yazar seçme

Mevcut aşama:
Örnek olaylar yayınlandı. Zaman çizelgesine bakın.

Bu sayfada, açık kaynak kuruluşlara Google Dokümanlar Sezonu proje önerileri için doğru teknik yazarı nasıl değerlendirecekleri ve seçecekleriyle ilgili ipuçları verilmektedir.

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.

İşlemi başlatma

Google Dokümanlar Sezonu'na katılmak isteyebilirsiniz. Bu nedenle, teknik yazar bulma sürecine hemen başlamanız önerilir.

Teknik yazarları değerlendirme

Teknik yazma becerilerini ve deneyimlerini değerlendirmek için, değerlendirmeye aldığınız teknik yazarlardan daha önce geliştirilmiş dokümanlar örneği 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 Dokümanlar 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ıyla ilgili deneyime sahip 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çiminde tutarlılık, doğru yazım ve net bir dil olup olmadığına bakın. Cümle yapısı basit mi yoksa karmaşık mı? Cümleler kısa mı yoksa takip edilmesi zor olana kadar mı uzuyor?

  • 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 işe alma

Kuruluşlar, 22 Mayıs 2024, 18:00 (UTC)'a kadar bir teknik yazar işe almalı ve aşağıda bağlantısı verilen Teknik Yazar İşe Alma Belgesi Formu'nu 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. Kuruluşların, proje başlangıcında yapılan ödeme de dahil olmak üzere proje aşamalarına göre teknik yazarlarla bir ödeme planı oluşturmaları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 22 Mayıs 2024, 18:00 (UTC) tarihine kadar Teknik Yazar İstihdamı Kanıtı Formu'nu göndermeyen kuruluşlar ilk ödeme tarihinde para almaz.