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 Google iş web sitesini ziyaret edin.

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ğuyla da iletişime geçebilirsiniz (Write the Docs Slack'teki #season-of-docs kanalını veya sosyal medya kanallarınızı kullanarak yardım isteyebilir ya da öneriler alabilirsiniz).

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 eklenecektir.

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ığıyla ilgili 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 güncellemeleri almak için gruba katılın.

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

Google Dokümanlar Sezonu takvimine abone olmak için http://goo.gle/2NeZVew adresini ziyaret edin.

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. Program kurallarını inceleyin ve örnek içeriği kullanın.

2019 ve 2020 programlarıyla ilgili paylaşabileceğiniz istatistikler var mı?

Evet, 2019 programıyla ilgili Google Dokümanlar Sezonu sonuçlarımızı Google Open Source Blog'da (2019, 2020) görebilirsiniz.

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

Hayır. Uluslararası gönderim kısıtlamaları nedeniyle Google Dokümanlar Sezonu, Google Dokümanlar Sezonu projelerini başarıyla tamamlayan katılımcılara artık tişört gönderemiyor.

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 sorularınızı tartışma listesinde Google Dokümanlar Sezonu topluluğuyla görüşebilirsiniz. Sohbet kanalları ve bize nasıl ulaşacağınız hakkındaki bilgileri inceleyin.

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 nasıl inceleneceğini ve onaylanacağını kuruluş başvurusu kapsamında belirtmelidir. Google Dokümanlar Sezonu kapsamında teknik yazarlara mentorluk yapmak istiyorsanız gönüllü olmak için kuruluş yöneticilerinizle iletişime geçin.

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

Hayır. Google Yazılım Yazma Sezonu, teknik yazım konusunda biraz deneyimi olan kişiler için tasarlanmıştır ve Google Yazılım Yazma Yaz Kampı 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şlarıyla 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 site oluşturuculardan biri 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 deneyin. Bu sayede açık kaynak projenize hızlı bir şekilde başlayabilir ve tercih ettiğiniz açık kaynak projesine sağlam tavsiyeler verebilirsiniz.

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 deneyiminizi veya teknik yazım konusunda aldığınız eğitimleri 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 Dokümanlar 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. Bir proje kapsamında katılmak istiyorsanız projeyle iletişime geçin ve bir başvuru önerisi üzerinde ortak çalışın.

Öğrenciyim. Google Dokü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 alakalı deneyime sahip olması beklenir. Programa katılmak isteyen öğrencilerin başvuruda bulunurken ilgili yazma ve düzenleme deneyimlerini vurgulamaları gerekir.

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

Google Yaz Kodu'na kabul edilen yeni katkıda bulunanların veya öğrencilerin Google Dokümanlar Sezonu teknik yazarı olmak için başvurması önerilmez.

Google Dokümanlar Sezonu, başlangıç seviyesindeki kullanıcılar için değil, teknik yazım 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ı belirlemek için kendi kendilerine organize olmaları ve motive olmaları 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: "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?

Google Dokümanlar Sezonu, teknik yazarlara proje katılımıyla ilgili sertifika veya onay gönderemez.

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 veya 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, programa katılabilmek için Open Source Initiative onaylı bir lisans kapsamında zaten yazılım üretip yayınlamış ve Google Dokümanlar Sezonu programının tamamı boyunca kuruluş yöneticileri olarak görev yapacak en az iki katkıda bulunana sahip olmalıdır.

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 her alt kuruluş için ayrı başvurular ve teklifler gönderin.

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

Hayır. 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) bağış 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 projesi 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 dokümanlar için 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. Kiraladığınız şirketin Open Collective üzerinden ödeme alabilmesi gerekir.

Teknik yazarımız program sona ermeden ayrıldı. Kuruluşumuz hâlâ kalan fonları almaya uygun mu?

Projelerin, program sona ermeden önce projenizi tamamlayacak yeni bir teknik yazar bulmaya çalışması önemle tavsiye edilir. 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 vaka çalışmanızda incelemeniz gerekir. Ö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. Deneyiminizle ilgili olarak diğer projelere ne önerirsiniz? Bu bilgileri örnek olayınıza ekleyin.

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

Maalesef Google Belgeler Sezonu, kuruluş başvurusu hakkında geri bildirim verememektedir.

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 ayrıntılı olan küçük projelere odaklanmayı, daha az ayrıntılı olan büyük projelere odaklanmayı tercih etmenizi öneririz. Projeniz için çok fazla alan uzmanlığı gerekiyorsa bu alandan olmayan birinin üzerinde ç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ı. Kuruluşumuz tekrar başvurabilir mi?

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.