Sık sorulan sorular (SSS)

Mevcut aşama:
2021 Belge Sezonu programı 14 Aralık 2021'de sona erdi. Zaman çizelgesini inceleyin.

Genel

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

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

2021 Google Dokümanlar Sezonu'nda neler değişti?

Google Dokümanlar Sezonu 2021'de ö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ı hibeler 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 2021 Dokümanlar Mevsimi'ne katılmak istiyor ancak nereden başlayacağımızı bilmiyoruz.

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

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ün veya özellikle ilgili kavramsal bir genel bakış ya da giriş yazma. 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 bir bütün olarak anlaşılmasını zorlaştırır. Teknik yazarlar bunu 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.

Bir video, Google Dokümanlar Sezonu için olası bir proje midir?

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.

Doküman denetimi, Google Dokümanlar Sezonu için makul bir proje midir?

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. Belgeniz çok azsa veya hiç yoksa projenize en yüksek öncelikli eksik belgeleri de eklemeyi düşünebilirsiniz.

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'ın Sezonundan nasıl haberdar olabilirim?

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'ın Sezon Tişörtü kazanacak mıyım?

Hayır. Uluslararası gönderim kısıtlamaları nedeniyle, Google Belgeler Sezonu proje çalışmalarını 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 belgeleri okuduktan sonra da bir yanıt alamadıysanız lütfen sorularınızı tartışma listesindeki Google Dokümanlar Sezonu topluluğuyla tartışmayı düşünün. Sohbet kanalları ve bize ulaşma hakkındaki bilgilere göz atın.

Google Dokümanlar Mevsimi için nasıl mentor olabilirim?

2021 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 Season of Docs, 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?

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

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

Kullanacağınız belgeleme araçları ve çerçeveleri, ç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 belgeleri için Markdown veya başka bir biçimlendirme dili kullanır. Seçtiğiniz kuruluşun hangi dili kullandığını öğrenmenizi ve söz dizimini öğrenmenizi ö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, belgelerini halihazırda 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 kurum, teknik yazarın projeyle daha önceki veya devam eden ilişkisini tekliflerinde belirtmelidir.

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

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

Daha önce teknik metin yazmış veya bu konuda eğitim almış olmak tercih edilir ancak gerekli 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ışan 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, 2021 Google Dokümanlar Sezonu'na katılmaya uygun muyum? Dokümanlar'ın Google Mevsimi bana teknik yazar olmayı öğretecek 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 bir deneyime sahip olmasını bekleriz. 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 olarak hem de Google Yaz Kodu'na öğrenci olarak katılabilir miyim?

Bu şu anda kurallara aykırı olmasa da Google Summer of Code'a kabul edilen öğrencilerin, Google Dokümanlar Sezonu teknik yazarı olmak için geçerli olmaması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. Belge 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?

Google Dokümanlar Sezonu Google programı yöneticileriyle, season-of-docs@google.com adresine e-posta göndererek iletişim kurabilirsiniz.

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

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

Özgeçmişimde Season of Docs'a nasıl referans verebilirim?

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

Dokümanlar Sezonu'na katılanlara bitirme 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.

Ayrıca, program kurallarında açıklanan uygunluk koşullarını ve ABD Hazinesi'nden gelen Yaptırım Programları ve Ülke Bilgileri'ni inceleyin.

"Kuruluş", açık kaynak projesine eşdeğer midir?

Bir kuruluşun bir veya daha fazla açık kaynak projesi olabilir. Vakıflar gibi bazı kuruluşlar, her biri bir veya daha fazla açık kaynak projesine sahip birden fazla alt kuruluşa sahip 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) bağış fonları üst kuruluş tarafından yönetilecek olsa bile her projenin kendi başvurusunu göndermesi gerekir.

Bir grup açık kaynak projesi tek bir belge projesi üzerinde çalışmak üzere birlikte teklif gönderebilir mi?

Bir kuruluş teklif başvurusunu göndermeli ve diğer katılımcı projelerin işlerini ve desteğini 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 bir Open Collective hesabı olmalıdır.

Kuruluşlar Google Dokümanlar Sezonu'na katılım karşılığında herhangi bir para alıyor mu?

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

Kuruluşum teknik yazar masrafları için nasıl bütçe ayırmalı?

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 yazarlık veya teknik iletişim programına ya da kursa 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 getirecek ve daha fazla gönüllülük ve yönetim süresi gerektirecektir.

Kuruluşum projemiz üzerinde çalışması için bir teknik yazı şirketiyle çalışabilir mi?

Evet, kuruluşunuz projeniz üzerinde çalışması için bir teknik yazı şirketi ile çalışabilir. 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 yazarı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.

Kurumsal başvurular, son gönderim 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, kurumunuza değer katacak en küçük projeleri bulmaya çalışın (ancak zaman kalırsa genişletilebilir). 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 alan uzmanlığı için çok fazla çaba gerektiriyorsa, bu alanda bilgi sahibi olmayan birinin üzerinde çalışabileceği projeler eklemeyi deneyin.

Google Dokümanlar Sezonu'na kuruluş yöneticisi olarak, Google Yaz Kodu'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şvurabilirler.

Arşivlenen veriler

Dokümanların Google Mevsimi arşivinden bilgilerimi nasıl kaldırabilirim?

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