Sık sorulan sorular (SSS)

Mevcut aşama:
Projenin tamamlanması. Zaman çizelgesine bakın.

Genel

Google Season of Docs bir işe alım programı mı?

Hayır. Google'da çalışmak istiyorsanız lütfen Google iş web sitesini ziyaret edin.

Mevcut program, Google Dokümanlar Sezonu 2019 ve 2020'den nasıl farklı?

Mevcut Google Dokümanlar Sezonu programında önceki yıllara kıyasla önemli değişiklikler yapıldı. Örneğin:

  • Teknik yazarlar artık kuruluşlarla eşleşmek için Google üzerinden başvuruda bulunmuyor
  • Kuruluşlar, başvurularının bir parçası olarak bütçe ve önerilen metrikler dahil olmak üzere proje önerileri gönderir.
  • Kabul edilen kuruluşlar, teknik yazarlara ödeme yapmak için kullandıkları bağışlar alır.
  • Kuruluşların nihai değerlendirmeleri ve örnek olaylarını göndermesi

Google Dokümanlar Sezonu bu değişiklikleri neden yaptı?

Google'ın misyonu, dünyanın bilgisini organize etmek ve onu evrensel olarak erişilebilir ve kullanışlı bir hale getirmektir. Google Dokümanlar Sezonu'nu, açık kaynakta etkili dokümanlar oluşturma uygulamaları hakkında bilgi edinmeye odaklanarak yeniden şekillendirerek uzun vadede daha büyük bir etki yaratmayı umuyoruz.

Kuruluşumuz Google Dokümanlar Sezonu'na katılmak istiyor ancak nereden başlayacağımızı bilmiyoruz.

Proje fikirlerimizin tam listesine göz atın. Teknik yazma topluluğuna da ulaşabilirsiniz (Write the Docs Slack'teki #season-of-docs kanalını veya sosyal medya kanallarınızı kullanarak yardım veya öneri isteyebilirsiniz).

Kuruluşlar ne tür projeler önerebilir?

Aşağıdaki önerilerden yararlanabilirsiniz:

  • Teknik yazar ve açık kaynak kuruluşu tarafından karar verilecek bir platformda doküman sitesi oluşturun ve sitede ilk temel doküman grubunu yayınlayın. Platformlara örnek olarak aşağıdakiler verilebilir:

  • Daha iyi bir kullanıcı deneyimi veya daha erişilebilir bir bilgi mimarisi sunmak için açık kaynak projenin mevcut belgelerini yeniden yapılandırın.

  • Bir ürüne veya özelliğe dair kavramsal bir genel bakış ya da giriş yazın. Ekipler genellikle teknik dokümanlarını alttan yukarıya doğru oluşturur. Bu da çok fazla ayrıntı olmasına rağmen ürünün bütün olarak anlaşılmasını zorlaştırır. Teknik bir yazar bu sorunu düzeltebilir.

  • Önemli bir kullanım alanı için eğitim içeriği oluşturun.

  • Belirli görevler için odaklanmış bir dizi nasıl yapılır kılavuzu oluşturun.

  • Açık kaynak projeye katkıda bulunmaya başlamayla ilgili temel bilgileri ve lisans sözleşmeleri, çekme istekleri ve incelemeler ile projeyi oluşturma gibi konulardaki tüm kuralları içeren bir katkıda bulunanlar rehberi oluşturun.

Google Dokümanlar Sezonu için video projeleri kabul edilir mi?

Evet. Video gereksinimlerinin kapsamının iyi belirlendiğinden emin olun ve yüksek kaliteli bir videonun üretilmesinin önemli miktarda zaman ve kaynak gerektirdiğini unutmayın.

Belge denetimi, Google Dokümanlar Sezonu için uygun bir proje mi?

Doküman denetimi, Google Dokümanlar Sezonu için mükemmel bir projedir. Mevcut dokümanlarınızın miktarını göz önünde bulundurun. Çok fazla dokümanınız varsa kapsamı daraltmanız (ör. yalnızca eğitim içeriğini denetlemek) gerekebilir. Çok az dokümanınız varsa veya hiç dokümanınız yoksa en yüksek öncelikli eksik dokümanları oluşturmayı projenize dahil edebilirsiniz.

Kuruluşların ve teknik yazarların kullanabileceği doküman şablonları var mı?

Google Dokümanlar Sezonu'nda, doküman denetimleri yapmak için şablon ve yapılacaklar listesi içeren bir GitHub deposu bulunmaktadır. Oluşturulan diğer şablonları da eklemeyi umuyoruz.

The Good Docs Project, açık kaynak için minimum düzeyde uygulanabilir doküman şablonları oluşturmak için çalışıyor.

Kuruluşların teknik yazarlar tarafından üretilen dokümanları kullanması zorunlu mu?

Hayır. Bazen projeler beklendiği gibi sonuçlanmaz veya şartlar değişir. Kuruluşların, oluşturulan dokümanları veya diğer materyalleri kullanmasını zorunlu tutmayız ancak nihai değerlendirme ve örnek olayda, dokümanların neden kullanılmadığı ve projenin dokümanları veya diğer materyalleri kullanmama kararını nasıl aldığı hakkında bir tartışmanın yer almasını bekleriz.

Google Dokümanlar Sezonu nerede gerçekleşir?

Google Dokümanlar Sezonu tamamen online olarak gerçekleşir. Program kapsamında seyahat etmeniz gerekmez.

Google Dokümanlar Sezonu hakkında nasıl bilgi edinebilirim?

Google Dokümanlar Sezonu ile ilgili en son güncellemeler ve duyurular için season-of-docs-announce adresindeki duyuru posta listesini ziyaret edin. E-posta üzerinden güncelleme almak için gruba katılın.

Google Dokümanlar Sezonu zaman çizelgesini takvime ekleyebilir miyim?

Evet, bu bağlantıyı kullanarak ekleyebilirsiniz.

Google Dokümanlar Sezonu'nu tanıtmak için ne yapabilirim?

Program hakkında tweet atabilir, blog yayınları yazabilir, video yayınlayabilir veya bölgenizde bir buluşma ya da bilgilendirme oturumu düzenleyebilirsiniz. Topluluğunuza (kuruluş, yazar grubu ve diğer kişiler) dağıtmak için kullanabileceğiniz bazı örnek içerik ve kaynaklar sunuyoruz.

Google Dokümanlar Sezonu bilgi oturumu veya buluşması nasıl düzenleyebilirim?

Sizin için uygun bir zamanda ve yerde buluşma planlayabilirsiniz. Lütfen program kurallarını inceleyin ve örnek içeriği kullanın.

2019 ve 2020 Dokümanlar Sezonları ile ilgili paylaşabileceğiniz istatistikler var mı?

Evet, 2019 programına ait Google Dokümanlar Sezonu sonuçlarımızı burada, 2020 programına ait sonuçlarımızı ise burada görebilirsiniz.

Google Dokümanlar Sezonu tişörtü alacak mıyım?

Hayır. Uluslararası gönderim kısıtlamaları nedeniyle, Google Belgeler Sezonu projelerini başarıyla tamamlayan katılımcılara artık tişört gönderemeyeceğiz.

Başka sorularım olursa ne yapmalıyım?

Kuruluş yöneticisi kılavuzuna ve teknik yazar kılavuzuna göz atın.

Tüm dokümanları okuduktan sonra hâlâ yanıt alamadıysanız lütfen sorularınızı tartışma listesinde Google Dokümanlar Sezonu topluluğuyla görüşün. Sohbet kanalları ve bize ulaşma hakkındaki bilgilere göz atın.

Google Dokümanlar Sezonu'nda nasıl mentor olabilirim?

Google Dokümanlar Sezonu'nda resmi bir mentor rolü yoktur. Kuruluşlar, teknik yazarların nasıl işe alınacağını ve destekleneceğini ve doküman katkılarının kuruluş başvurusu kapsamında nasıl incelenip onaylanacağını belirtmelidir. Google Dokümanlar Sezonu kapsamında teknik yazarlara mentorluk yapmak istiyorsanız kuruluşunuzun yöneticileriyle birlikte gönüllü olarak çalışmanızı öneririz.

Google Dokümanlar Sezonu, Google Summer of Code ile aynı mı?

Hayır. Google Dokümanlar Sezonu, teknik yazım konusunda biraz deneyimi olan kişiler için tasarlanmıştır ve Google Yaz Kodu Sezonu gibi bir mentorluk programı değildir.

Teknik yazarlar için

Teknik yazarlar Google Dokümanlar Sezonu'na ne zaman başvurabilir?

Google Dokümanlar Sezonu'nda resmi bir teknik yazar başvurusu yoktur. Google Dokümanlar Sezonu'na teknik yazar olarak katılmak için Google Dokümanlar Sezonu program sayfalarındaki talimatları kullanarak doğrudan açık kaynak kuruluşlarla iletişime geçin. Ayrıca, Google Dokümanlar Sezonu Teknik Yazar Dizini'ne kendinizi ekleyerek de ilginizi belirtebilirsiniz. Daha fazla bilgi için teknik yazar kılavuzuna bakın.

Google Dokümanlar Sezonu'na katılmak için hangi dokümanlar araçlarını ve çerçevelerini bilmem gerekir?

Kullanacağınız dokümantasyon araçları ve çerçeveleri, birlikte çalışmak istediğiniz kuruluşa bağlıdır. Google Dokümanlar Sezonu'nun bir amacı, açık kaynak projelerinin teknik yazarların açık kaynak ürünlerini belgelemeyle ilgili araç ve çerçeveler hakkında daha fazla bilgi edinmesine yardımcı olmasıdır. Bu nedenle, Google Belge Sezonu projenize başlamadan önce belirli doküman platformları hakkında ayrıntılı bilgi sahibi olmanız genellikle gerekmez.

Bununla birlikte, çoğu açık kaynak kuruluşu dokümanları için bir tür Markdown veya başka bir biçimlendirme dili kullanır. Seçtiğiniz kuruluşun hangi dili kullandığını öğrenmenizi ve söz dizimi hakkında bilgi edinmenizi öneririz. GitHub README dosyaları Markdown'ın bir çeşidini kullandığından Markdown ile başlamak iyi bir fikirdir. GitHub'ın Markdown rehberine göz atın.

Seçtiğiniz kuruluşun dokümanlarını bir web sitesinde barındırıp barındırmadığını ve barındırıyorsa hangi platformu kullandığını öğrenin. Platform, Jekyll, Sphinx veya Hugo gibi statik bir site oluşturucu olabilir ya da kuruluş, dokümanlarını Read the Docs veya GitHub Pages'da barındırıyor olabilir. Kuruluşun kullandığı platformu öğrendikten sonra ilgili dili ve çerçeveyi keşfedin ve denemeler yapın. Bu, açık kaynak projenize hızlı bir şekilde başlamanıza yardımcı olur ve seçtiğiniz açık kaynak projesine sağlam tavsiyeler vermenizi sağlar.

Google Dokümanlar Sezonu projelerine katılmak için hangi programlama dillerini bilmem gerekir?

Belgeleme projenizin yapısına bağlı olarak bir programlama dilini bilmeniz gerekebilir. Belge projesi seçerken ve önerirken bunu göz önünde bulundurun ve gerekli bilgi düzeyi hakkında açık kaynak kuruluşuna danışın.

Halihazırda açık kaynak bir proje üzerinde çalışan teknik yazarlar, Google Dokümanlar Sezonu kapsamında bu proje üzerinde çalışmaya devam edebilir mi?

Evet, ancak kuruluş, teknik yazarın projeyle daha önce veya hâlihazırda olan ilişkisini teklifinde belirtmelidir.

Katılım için uygunluk koşulları nelerdir?

Teknik yazar olarak önceden deneyim sahibi olmam veya eğitim almam gerekir mi?

Teknik yazım deneyimi veya eğitimi tercih edilir ancak zorunlu değildir. Bir kuruluşa ilgi beyanı gönderirken teknik yazma konusundaki deneyiminizi ve/veya eğitiminizi açıklayabilirsiniz. Yazdığınız doküman örnekleri de dahil olmak üzere, teknik dokümanlara veya açık kaynak dokümanlara olan ilginizi gösteren bazı kanıtlar sunabilmeniz gerekir. Açık kaynak kuruluşu, Google Belge Sezonu projelerinin başarıyla tamamlanmasını sağlamak için ihtiyaç duyduğu deneyim düzeyine sahip teknik yazarlar arar.

Google Dokümanlar Sezonu'na katıldığım için ödeme alacak mıyım?

Evet. Google, kabul edilen kuruluşlara teknik yazar istihdam etmek için kullanacakları bağışlar sağlayacaktır.

İyi bir teknik yazarın ilgi beyanı nasıl olmalıdır?

En ilgi çekici beyanlar, beyanlarını göndermeden önce seçtikleri açık kaynak kuruluşuyla etkileşime geçerek fikirlerini tartışmayı ihmal etmeyen teknik yazarlardan gelir. İlgi beyanınızı oluşturma başlıklı rehbere bakın.

Google Dokümanlar Sezonu'na katılmak ne kadar sürer?

Proje boyutları değişiklik gösterir ancak program sırasında haftada 5-30 saatlik bir taahhüt gerektirir. Ancak harcayacağınız süre, kuruluşunuzla anlaştığınız projenin yapısına bağlıdır. Taahhütte bulunmadan önce projeyi değerlendirmeniz ve açık kaynak kuruluşuyla süre tahminini görüşmeniz gerekir.

Bireysel olarak açık kaynak bir proje için doküman oluşturmak üzere kuruluş başvurusu gönderebilir miyim? Açık kaynak bir projenin veya aracın nasıl kullanılacağıyla ilgili bir dizi blog yayını, video veya başka materyaller oluşturmak istiyorum ancak projenin parçası değilim veya projeye katkıda bulunmuyorum.

Hayır, yalnızca açık kaynak proje adına fon alabiliyorsanız teklif göndermeniz gerekir. Projeyle iletişime geçerek bir uygulama önerisi üzerinde ortak çalışmanızı öneririz.

Öğrenciyim. Google Dökümanlar Sezonu'na katılabilir miyim? Google Dokümanlar Sezonu bana teknik yazar olmayı öğretir mi?

Öğrenciler, kabul edilen kuruluşlarla çalışmaya uygundur ancak Google Belgeler Sezonu, teknik yazma becerilerini öğretmek için tasarlanmamıştır. Katılan teknik yazarların profesyonel teknik yazma becerilerine veya eşdeğer ilgili deneyime sahip olmasını bekliyoruz. Programa katılmak isteyen öğrenciler, ilgilenen kuruluşlara ve projelere ulaşırken ilgili yazma ve düzenleme deneyimlerini vurgulamalıdır.

Hem Google Dokümanlar Sezonu'na teknik yazar hem de Google Yaz Kodu'na öğrenci olarak katılabilir miyim?

Şu anda kurallara aykırı olmasa da Google Yazılım Kampı'na kabul edilen öğrencilerin Google Dokümanlar Sezonu teknik yazarı olmak için başvurmamalarını önemle tavsiye ederiz. Öğrenciler, Google Dokümanlar Sezonu'na başvurmak yerine Google Yaz Kodu Kampı çalışmalarına odaklanmalıdır.

Ayrıca Google Dokümanlar Sezonu, başlangıç seviyesindeki kullanıcılar için değil, teknik yazma konusunda iyi veya çok iyi beceri ve deneyime sahip kullanıcılar için tasarlanmıştır. Google Dokümanlar Sezonu'ndaki teknik yazarlara mentorluk yapılmaz. Bunun yerine, kuruluş yöneticilerinden ve diğer topluluk üyelerinden minimum düzeyde rehberlik alarak kuruluşun projesini ele alma planlarını kendileri belirlemeleri gerekir.

Teknik yazar olarak başka sorular veya endişelerim olursa Google Dokümanlar Sezonu Google program yöneticileriyle nasıl iletişime geçebilirim?

season-of-docs@google.com adresine e-posta göndererek Google Dokümanlar Sezonu Google program yöneticileriyle iletişime geçebilirsiniz.

Teknik yazım şirketi veya danışmanlık firması Google Dokümanlar Sezonu'na katılabilir mi?

Evet, bir kuruluş teklifinde belirtilen işi yapmak için bir şirket tutabilir.

Google Dokümanlar Sezonu'nu özgeçmişimde nasıl referans olarak gösterebilirim?

Diğer serbest çalışmalarda yaptığınız gibi listeleyin. Örneğin, "Google Dokümanlar Sezonu programı kapsamında [proje adı] için teknik yazar olarak çalıştım."

Google Dokümanlar Sezonu'na katılanlara katılım sertifikası veriyor musunuz?

Teknik yazarlara proje katılımıyla ilgili sertifika veya onay gönderemiyoruz.

Açık kaynak kuruluş yöneticileri için

Açık kaynak kuruluşları için uygunluk koşulları nelerdir?

Kuruluş olarak programa katılmaya uygun olmak için BRL-CAD gibi etkin bir ücretsiz/açık kaynak yazılım projesi yürüten bir grup olmanız gerekir. Projenin yasal olarak tüzel kişiliğe sahip olması gerekmez. Kuruluşların programa katılabilmesi için Open Source Initiative onaylı bir lisans kapsamında önceden yazılım üretip yayınlamış olması ve Google Dokümanlar Sezonu programının tamamı boyunca kuruluş yöneticileri olarak görev yapacak en az iki katkıda bulunanı olması gerekir.

Program kurallarında ve ABD Hazine Bakanlığı'nın Yaptırım Programları ve Ülke Bilgileri bölümünde açıklanan uygunluk koşullarına da göz atın.

"Kuruluş", açık kaynak projesiyle eşdeğer mi?

Bir kuruluşun bir veya daha fazla açık kaynak projesi olabilir. Vakıflar gibi bazı kuruluşların, her biri bir veya daha fazla açık kaynak projesine sahip birden fazla alt kuruluşu olabilir. Kuruluşunuzun bağımsız alt kuruluşları varsa lütfen her alt kuruluş için ayrı başvurular ve teklifler gönderin.

Bir kuruluş birden fazla teklif başvurusu gönderebilir mi?

Hayır. Lütfen kuruluş başına yalnızca bir başvuru gönderin. Kuruluşunuzun alt kuruluşları varsa (ör. kuruluşunuz birçok bağımsız açık kaynak projesine sahip bir vakıfsa) hibe fonları üst kuruluş tarafından yönetilecek olsa bile her projenin kendi başvurusunu göndermesi gerekir.

Bir açık kaynak projesi grubu, tek bir doküman projesi üzerinde çalışmak için birlikte teklif gönderebilir mi?

Teklif başvurusunu bir kuruluş göndermeli ve diğer katılımcı projelerden gelen çalışmaları ve desteği koordine etmekten sorumlu olmalıdır. (Örneğin, daha büyük bir projenin eklentileri olan küçük bir açık kaynak proje grubu, eklenti oluşturmayla ilgili ortak bir kullanım kılavuzu üzerinde çalışmak istiyorsa projeye liderlik edecek bir kuruluş seçmelidir.)

Kuruluşum parayı nasıl alacak?

Para alabilmek için kuruluşunuzun Open Collective hesabı olmalıdır.

Kuruluşlar, Google Dokümanlar Sezonu'na katılmak için para alıyor mu?

Kuruluşlar, proje bütçelerine yönetim, mentorluk veya çalışmayı incelemeyle ilgili fonlar dahil edebilir.

Google, ödeme işleme ücretlerini karşılar mı?

Ödeme yöntemine bağlı olarak değişiklik gösterdiğinden ödeme işleme ücretleri Google tarafından karşılanmamaktadır. Ancak Google, Open Collective platform ücretini karşılar. Mali barındırma hizmetiniz olarak Open Collective'i kullanmaya karar verirseniz bu ücret de karşılanır. Daha fazla bilgi için Bağış alma kılavuzuna bakın.

Kuruluşum teknik yazar maliyetini nasıl bütçelendirmelidir?

Write the Docs maaş anketine göz atmanızı ve saatlik ücretleri hesaplamanızı öneririz. Ayrıca Write The Docs Slack'a katılabilir ve #season-of-docs kanalında ilgilenen teknik yazarlardan teklif vermelerini isteyebilirsiniz.

Kuruluşum, Google Dokümanlar Sezonu hibesini mevcut bir katkıda bulunana ödeme yapmak için kullanabilir mi?

Evet. Ancak proje teklifleri yeni çalışmalar için olmalıdır (bakım çalışmaları, düzeltme veya mevcut belgelerde yapılan yükseltmeler dahil). Tamamlanmış çalışmaların ödemesi için kullanılacak bir hibe başvurusunda bulunamazsınız.

Kuruluşum öğrenci teknik yazarlarla çalışabilir mi?

Projenizde teknik yazar öğrenci çalıştırmayı seçebilirsiniz. Öğrencilerle çalışmayı seçerseniz katılımı aşağıdaki özelliklere sahip öğrencilerle sınırlamanızı önemle tavsiye ederiz:

  • 18 yaşından büyük olmanız gerekir.
  • Teknik yazma veya teknik iletişim programına ya da kursuna kayıtlı olmak
  • Program veya kursları aracılığıyla teknik yazma mentorluğuna erişebilmelidir.

Kuruluşum birden fazla teknik yazarla çalışabilir mi?

Kuruluşunuz birden fazla teknik yazar seçip onlara ödeme yapabilir ancak kuruluşunuzla çalışan tüm teknik yazarlar, önerdiğiniz proje üzerinde çalışmalıdır. Birden fazla teknik yazarla çalışmak projenizi daha karmaşık hale getirir ve daha fazla gönüllü ve yönetim zamanı gerektirir.

Kuruluşum, projemiz üzerinde çalışmak için teknik yazım şirketi tutabilir mi?

Evet, kuruluşunuz projeniz üzerinde çalışmak için teknik yazım şirketi tutabilir. Lütfen işe aldığınız şirketin Open Collective üzerinden ödeme alabileceğinden emin olun.

Teknik yazarımız program sona ermeden ayrıldı. Kalan tutarı almaya devam edebilir miyiz?

Programın sona ermesinden önce projenizi tamamlayacak yeni bir teknik yazar bulmaya çalışmanızı önemle tavsiye ederiz. Ancak kalan fonların ödenmesi, projenin tamamlanmasına değil, örnek çalışmanın ve nihai değerlendirmenin tamamlanmasına bağlıdır.

Projeniz tamamlanamadıysa nedenini incelemenizi bekliyoruz. Örneğin, doküman araçlarınızın çok karmaşık olduğunu ve teknik yazarların ilk katılımını engellediğini veya projenizin eğitim dokümanlarını test etmeyi ve güncellemeyi gerektirdiğini ve kapsamlı kodlama deneyimi gerektirdiğini fark etmiş olabilirsiniz. Deneyimlerinize dayanarak diğer projelere ne önerirsiniz? Bu bilgileri örnek olayınıza ekleyin.

Kuruluş başvuruları gönderim son tarihinden önce incelenebilir mi?

Maalesef kuruluş başvurusu hakkında geri bildirim veremiyoruz.

Kuruluşlar proje tekliflerinin kapsamını nasıl belirlemelidir?

Proje fikirleri geliştirirken, kuruma değer katacak (ancak zaman izin veriyorsa genişletilebilir) en küçük projeleri bulmaya çalışın. Ne kadar küçük olursa o kadar iyidir. Proje teklifinizi oluştururken, daha az ayrıntılı olan büyük projeler yerine daha küçük ve daha ayrıntılı projelere odaklanmanızı öneririz. Projeniz için çok fazla alan uzmanlığı gerekiyorsa bu alanda deneyimi olmayan birinin çalışabileceği projeler eklemeye çalışın.

Google Dokümanlar Sezonu'na kuruluş yöneticisi olarak, Google Yaz Kodu Kampı'na ise mentor olarak katılabilir miyim?

Evet. Google Dokümanlar Sezonu ve Google Summer of Code ayrı programlardır. Her iki programa da katılmak için zamanınız varsa sorun değil.

Kuruluşumuz daha önceki Google Dokümanlar Sezonu programlarına katıldı. Tekrar başvurabilir miyiz?

Evet, önceki Google Dokümanlar Sezonu programlarına katılan kuruluşlar tekrar başvuru yapabilir.

Arşivlenen veriler

Bilgilerimi Google Belgeler Sezonu arşivinden nasıl kaldırırım?

Bilgilerinizin kaldırılması için bize ulaşın.