Mevcut aşama:
Belge geliştirme Zaman çizelgesini inceleyin.
Genel
Dokümanlar Google Sezonu bir işe alım programı mı?
Hayır. Google için çalışmak istiyorsanız Google iş fırsatları web sitesini ziyaret edin.
Kuruluşumuz Google Dokümanlar Sezonu'na katılmak istiyor ama nereden başlayacağımızı bilmiyoruz!
Proje fikirlerimizin tam listesine göz atın. Ayrıca teknik yazarlar topluluğuna ulaşabilirsiniz (
Sezonu belgeleri kanalıyla
Yardım veya teklif istemek için Dokümanlar Slack'i yazabilir veya sosyal medya kanallarınıza yazabilirsiniz).
Kurumlar ne tür projeler önerebilir?
Aşağıdaki önerilerden yararlanabilirsiniz:
Teknik yazar ve açık kaynak kuruluşunun karar vereceği platformda bir belge sitesi oluşturun ve sitede ilk temel belge grubunu yayınlayın. Platformlara örnek olarak aşağıdakiler verilebilir:
- Belgeleri okuyun
- Hugo, Jekyll, Sphinx ve diğer gibi bir statik site oluşturma aracı
- GitHub Sayfaları
Daha iyi bir kullanıcı deneyimi sunmak veya daha erişilebilir bir bilgi mimarisi sağlamak için açık kaynak projenin mevcut belgelerini yeniden düzenleyin.
Bir ürün veya özellikle ilgili kavramsal bir genel bakış ya da tanıtım yazın. Ekip genellikle teknik belgelerini aşağıdan yukarıya oluşturur. Sonuçta çok fazla ayrıntı vardır ama ürünü bir bütün olarak anlamak da zorlaşır. Teknik yazarlar bu sorunu düzeltebilir.
Önemli bir kullanım alanı için eğitim oluşturun.
Belirli görevlere odaklanmış bir dizi "Nasıl Yapılır?" kılavuzu oluşturun.
Açık kaynak projesine katkıda bulunan olarak çalışmaya başlama hakkında temel bilgilerin yanı sıra lisans sözleşmeleri, pull talepleri ve inceleme süreçleri, projeyi oluşturmak vb. kurallar ile ilgili kuralları içeren katkıda bulunanlar için bir kılavuz oluşturun.
Bir video, Google Dokümanlar Sezonu için olası bir proje midir?
Evet. Video gereksinimlerinin kapsamlı olduğundan emin olun ve yüksek kaliteli video prodüksiyonunun ö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 Google Sezonu için harika bir projedir. Elinizde ne kadar çok belge olduğuna dikkat edin; çok fazla belgeniz varsa kapsamı azaltmanız gerekebilir (örneğin, yalnızca eğitim içeriğini denetleme). Çok az belgeniz varsa veya hiç belgeniz yoksa projenizin bir parçası olarak en yüksek öncelikli eksik belgeleri oluşturmak isteyebilirsiniz.
Kuruluşların ve teknik yazarların kullanabileceği doküman şablonları var mı?
Google Sezon, doküman denetimleri yapmak için kullanılabilecek bir şablon ve yapılacaklar listesi içeren bir GitHub deposuna sahiptir. Diğer şablonlar oluşturuldukça eklenir.
İyi Dokümanlar Projesi, açık kaynak için en azından minimum uygulanabilir belge şablonları oluşturmak üzere çalışıyor.
Kuruluşların, teknik yazarlar tarafından oluşturulan belgeleri kullanması zorunlu mudur?
Hayır. Zaman zaman projeler beklendiği gibi çıkmaz veya gereksinimler değişir. Kuruluşların üretilen belgeleri veya diğer malzemeleri kullanmalarını şart koşmuyoruz ama son değerlendirme ve vaka çalışmasının, belgelerin neden kullanılmadığı ve projenin belgeleri veya diğer malzemeleri kullanmama kararını nasıl verdiği hakkında bir tartışma içermesini bekliyoruz.
Dokümanlar'ın Google Sezonu nerede ortaya çıkıyor?
Dokümanlar'ın Google Sezonu tamamen çevrimiçi olarak gerçekleşir. Program kapsamında seyahate gerek yoktur.
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 güncellemelerini almak için gruba katılın.
Dokümanlar'ın Google Sezonu zaman çizelgesini takvimime ekleyebilir miyim?
Google Dokümanlar Sezonu takvimine abone olmak için http://goo.gle/2NeZVew kullanın.
Google Dokümanlar Sezonu'nu tanıtmaya yardımcı olmak için ne yapabilirim?
Program hakkında tweet gönderebilir, blog yayınları yazabilir, video yayınlayabilir veya bulunduğunuz bölgede 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 Sezonunu Dokümanlar bilgi oturumu veya buluşmasını nasıl düzenleyebilirim ya da düzenleyebilirim?
Sizin için uygun olan zaman ve yerde toplantı planlayabilirsiniz. Program kurallarını inceleyin ve örnek içeriği kullanın.
2019 ve 2020 programlarıyla ilgili paylaşabileceğiniz herhangi bir istatistik var mı?
Evet, 2019 programı için Google Dokümanlar Sezon sonuçlarımız Googlel Açık Kaynak Blogu'nda (2019, 2020) görüntülenebilir.
Google Season of Docs Tişörtü alacak mıyım?
Hayır, uluslararası gönderim kısıtlamaları nedeniyle Google Dokümanlar'da Google Dokümanlar projesini başarıyla tamamlayan katılımcılara artık tişört sağlanmamaktadır.
Başka sorularım olursa ne yapmam gerekir?
Kuruluş yöneticisi kılavuzuna ve teknik yazar kılavuzuna göz atın.
Tüm dokümanları okuduktan sonra hâlâ bir yanıtınız yoksa, sorularınızı tartışma listesinde Google Dokümanlar'ın Sezonu topluluğuyla tartışmayı düşünün. Tartışma kanalları hakkındaki bilgilere ve bize nasıl ulaşabileceğinize göz atın.
Google Dokümanlar Sezonu için nasıl mentor olabilirim?
Google Dokümanlar Sezonunda resmi bir mentor rolü yoktur. Kuruluşlar, teknik yazarların ilk katılım ve desteklenme şeklini, belge katkılarının kuruluş başvurusu kapsamında nasıl incelenip onaylanacağını belirtmelidir. Google Dokümanlar Sezonu kapsamında teknik yazarlara mentorluk yapmakla ilgileniyorsanız gönüllü olmak için kuruluşunuzun yöneticileriyle iletişime geçin.
Dokümanlar'ın Google Sezonu Google Summer of Code gibi midir?
Hayır. Google Dokümanlar Sezonu bir miktar teknik yazım deneyimi olan kişiler için tasarlanmıştır. Google Summer of Code gibi bir mentorluk programı olarak tasarlanmamıştır.
Teknik yazarlar için
Teknik yazarlar Google Dokümanlar Google Sezonu için ne zaman başvurabilir?
Dokümanlar Google Sezonu'nda resmi bir teknik yazar uygulaması yoktur. Teknik yazar olarak Google Dokümanlar Google Sezonu programına katılmak için, açık kaynak kuruluşlarla doğrudan iletişim kurun. Bunun için kendi Google Dokümanlar Sezonu program sayfalarındaki talimatları kullanın. Kendinizi Google Dokümanlar Teknik Yazar Dizini'ne ekleyerek de ilgilendiğinizi belirtebilirsiniz. Daha fazla bilgi için teknik yazar kılavuzuna bakın.
Google Dokümanlar Sezonu'na katılmak için hangi doküman araçlarını ve çerçevelerini bilmem gerekiyor?
Kullanacağınız belge araçları ve çerçeveler, çalışmak istediğiniz kuruluşa bağlı olarak farklılık gösterir. Google Dokümanlar Sezonunun amacının bir parçası da teknik yazarların açık kaynak ürünlerin belgelenmesinde yer alan araçlar ve çerçeveler hakkında daha fazla bilgi edinmesine yardımcı olmaktır. Bu nedenle, Google Dokümanlar Mevsimi projenize başlamadan önce belirli belge platformları hakkında ayrıntılı bilgi sahibi olmanız genellikle şart değildir.
Bununla birlikte, çoğu açık kaynak kuruluşu belgeleri için Markdown'ı veya başka bir işaretleme dilini kullanır. Seçtiğiniz kuruluşta kullanılan dili öğrenmenizi ve söz dizimiyle ilgili bilgi edinmenizi öneririz. GitHub BENİOKU dosyaları Markdown'ın bir tatını kullandığından, Markdown iyi bir başlangıçtır. Markdown için GitHub kılavuzuna bakın.
Seçtiğiniz kuruluşun belgelerini bir web sitesinde barındırıp barındırmadığını ve barındırılıyorsa hangi platformu kullandığını öğrenin. Platform; Jekyll, Sphinx veya Hugo gibi statik bir site oluşturma aracı olabilir ya da kuruluş, dokümanlarını Dokümanlar'ı okuyun veya GitHub Sayfaları'nda barındırabilir. Kurumun hangi platformu kullandığını öğrendiğinizde ilgili dili ve çerçeveyi keşfedin ve bunlarla denemeler yapın. Böylece açık kaynak projenize hemen başlayabilirsiniz ve seçtiğiniz açık kaynak projesine sağlam tavsiyelerde bulunabileceğiniz iyi bir yer olur.
Google Dokümanlar Sezonu projelerine katılmak için hangi programlama dillerini bilmem gerekir?
Belgeleme projenizin niteliğine bağlı olarak bir programlama diline aşina olmanız gerekebilir. Bir belgeleme projesi seçerken ve teklif ederken bunu göz önünde bulundurun ve gerekli bilgi düzeyi konusunda açık kaynak kuruluşuna danışın.
Halihazırda açık kaynak bir projede çalışan teknik yazarlar, Google Dokümanlar Sezonu kapsamında bu proje üzerinde çalışmaya devam edebilir mi?
Evet, ancak kuruluş, teklifinde teknik yazarın projeyle önceki veya devam eden ilişkisini not etmelidir.
Katılım için uygunluk koşulları nelerdir?
- ABD ambargosu uygulanmayan bir ülkede ikamet etmeniz gerekir. Program kurallarını ve ABD Hazinesi'nden Yaptırım Programları ve Ülke Bilgilerini inceleyin.
Teknik yazar olarak önceden deneyime veya eğitime ihtiyacım var mı?
Daha önce teknik metin yazma deneyimi ya da eğitim almış olmak tercih edilir ancak gerekli değildir. Bir kuruma menfaat bildirimi gönderdiğinizde, deneyiminizi veya teknik yazım konusunda aldığınız herhangi bir eğitimi anlatabilirsiniz. Teknik belgelere veya açık kaynaklı belgelere gösterdiğiniz ilgiyi gösteren kanıtları sağlamanız gerekir. Örneğin, yazdığınız belgelerden örnekler verebilirsiniz. Açık kaynak kuruluşu, Google Dokümanlar Sezon projelerinin başarıyla tamamlanmasını sağlamak için kuruluşun ihtiyaç duyduğu deneyim düzeyine sahip teknik yazarlar arayacaktır.
Google Dokümanlar Sezonuna katılım karşılığında ödeme alacak mıyım?
Evet. Google, teknik yazarlar çalıştırmak üzere kabul edilen kuruluşlara bağışlar sağlayacaktır.
İyi bir teknik yazar menfaat bildirimi nasıl görünür?
Bu konudaki en iyi ifadeler, ifadelerini göndermeden önce, seçtikleri açık kaynak kuruluşla iletişim kurmak ve fikirlerini tartışmak için zaman ayıran teknik yazarlar olacaktır. İlgi beyanınızı oluşturma kılavuzuna bakın.
Google Dokümanlar Sezonu katılımı ne kadar sürer?
Projelerin büyüklükleri değişiklik gösterir, ancak program süresince haftada 5-30 saatlik bir taahhüt belirlenebilir. Ancak harcadığınız süre, kuruluşunuzla üzerinde anlaştığınız projenin yapısına bağlıdır. Projeyi imzalamadan önce projeyi değerlendirmeli ve açık kaynak kurumla proje üzerine bir tahmin üzerine konuşmalısınız.
Bireysel olarak bir açık kaynak projesine ilişkin belge oluşturmak için kuruluş başvurusu gönderebilir miyim? Bir açık kaynak projesinin veya aracının nasıl kullanılacağıyla ilgili bir dizi blog yayını, video veya başka materyaller oluşturmak istiyorum ancak bu projenin bir parçası veya katkıda bulunmuyorum.
Hayır, yalnızca açık kaynak projesinin adına para alabiliyorsanız teklif göndermelisiniz. Proje kapsamında katılmak istiyorsanız projeyle iletişime geçin ve bir uygulama teklifi üzerinde iş birliği yapın.
Öğrenciyim, Google Dokümanlar Sezonu'na katılmak için uygun muyum? Dokümanlar'ın Google Sezonu bana teknik yazar olmayı öğretecek mi?
Öğrenciler, kabul edilen kuruluşlarla çalışmak için uygundur ancak Google Dokümanlar'da Google Sezon, teknik yazma becerilerini öğretmek için tasarlanmamıştır. Katılımcı teknik yazarların profesyonel teknik yazma becerilerine veya eşdeğer deneyime sahip olması beklenir. Katılmak isteyen öğrenciler başvuru sırasında alakalı yazma ve düzenleme deneyimlerini vurgulamalıdır.
Hem Google Dokümanlar Sezonu'na teknik yazar hem de Google Summer of Code öğrencisi olarak katılabilir miyim?
Google Summer of Code'a kabul edilen yeni katkıda bulunanların veya öğrencilerin, Google Dokümanlar Google Sezonu teknik yazarı olmak için başvurmaları önerilmez.
Google Dokümanlar yeni başlayanlar için değil, zaten mükemmel düzeyde teknik yazma becerilerine ve deneyimine sahip kişiler için tasarlanmıştır. Google Dokümanlar Sezonu'ndaki teknik yazarlara akıl hocalığı yapılmaz. Bunun yerine, kuruluş yöneticileri ve diğer topluluk üyelerinden asgari rehberlik alarak kuruluşun projesini ele almaya yönelik planlarını belirlerken kendi kendilerini organize olmaları ve motive olmaları gerekir.
Teknik yazar olarak, sorularım veya endişelerim olursa Google Dokümanlar'ın Google Sezonu Google program yöneticileriyle nasıl iletişim kurabilirim?
Google Dokümanlar Google Sezonluk Google programı yöneticileriyle iletişime geçmek için season-of-docs@google.com adresine e-posta gönderebilirsiniz.
Teknik yazı şirketi veya danışmanlık şirketi, Google Dokümanlar Sezonu'na katılabilir mi?
Evet, bir kuruluş teklifte belirtilen işleri yapmak için bir şirketle anlaşabilir.
Özgeçmişimde Google Dokümanlar Sezonu'na nasıl referans verebilirim?
Diğer serbest çalışma çalışmalarında olduğu gibi listeleyin: "Google Dokümanlar Sezonu programının bir parçası olarak [proje adı] için teknik yazar olarak çalıştım."
Google Dokümanlar Sezonu'na katılım için bitirme sertifikası veriyor musunuz?
Dokümanlar Google Sezonu, teknik yazarlara proje katılım sertifikaları veya onay gönderemez.
Açık kaynak kuruluş yöneticileri için
Açık kaynak bir kuruluşun uygunluk koşulları nelerdir?
Kuruluş olarak katılmaya uygun olabilmeniz için BRL-CAD gibi etkin bir ücretsiz veya açık kaynak yazılım projesini yürüten bir grup olmanız gerekir. Projenin yasal olarak tüzel kişiliğe sahip olması gerekmez. Kuruluşların programa katılabilmeleri için Açık Kaynak Girişimi onaylı lisans kapsamında halihazırda yazılım üretip yayınlamış olmaları ve Google Dokümanlar Sezonu programının tamamında kuruluş yöneticisi olarak hizmet verecek en az iki katkıda bulunana sahip olmaları gerekir.
Program kurallarında açıklanan uygunluk koşullarına ve ABD Hazine Bakanlığı'nın Yaptırım Programları ve Ülke Bilgileri'ne de göz atın.
"Kuruluş", açık kaynak projesine 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 projesi bulunan birden fazla alt kuruluşu olabilir. Kuruluşunuzun bağımsız alt kuruluşları varsa her bir alt kuruluş için ayrı başvuru 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 (örneğin, kuruluşunuz birçok farklı açık kaynak projesine sahip bir vakıfsa) hibe fonları şemsiye kuruluş tarafından yönetilecek olsa bile her proje kendi başvurusunu göndermelidir.
Bir grup açık kaynak proje, tek bir belge projesi üzerinde çalışmak için birlikte teklif gönderebilir mi?
Bir kuruluş, teklif başvurusunu göndermeli ve diğer katılımcı projelerdeki çalışmaları ve desteği koordine etmekten sorumlu olmalıdır. (Örneğin, büyük bir projenin eklentileri olan ve eklentiler oluşturmak için ortak bir "nasıl yapılır" kılavuzu üzerinde çalışmak isteyen küçük açık kaynak projelerden oluşan bir grup, projeyi yönetmek için tek bir kuruluş seçmelidir.)
Kuruluşum ödemeleri nasıl alacak?
Fon alabilmek için kuruluşunuzun bir Open Collective hesabı olmalıdır.
Kuruluşlar Google Dokümanlar Sezonu'na katılım için herhangi bir ödeme alıyor mu?
Kuruluşlar proje bütçelerinin bir parçası olarak yönetim, mentorluk veya inceleme fonları içerebilir.
Ödeme işlemi ücretleri Google tarafından karşılanıyor mu?
Ödeme işleme ücretleri, ödeme yöntemine bağlı olarak farklılık gösterdiğinden Google tarafından karşılanmaz. Bununla birlikte, Open Collective platform ücreti Google tarafından karşılanır ve mali barındırıcınız olarak Open Collective'i kullanmaya karar verirseniz bu ücret de karşılanır. Daha fazla bilgi için Burs Alma kılavuzuna bakın.
Kuruluşum teknik yazarlık masrafları için nasıl bir bütçe oluşturmalı?
Dokümanlar maaş anketini yazma bölümüne bakmanızı ve saatlik ücretleri hesaplamanızı öneririz. Ayrıca Write The Docs Slack'e katılabilir ve #season-of-docs kanalında ilgi gösteren teknik yazarların teklif vermesini isteyebilirsiniz.
Kuruluşum, mevcut bir katkıda bulunan kullanıcıya ödeme yapmak için Dokümanlar'ın Google Sezonu hibesini kullanabilir mi?
Evet. Ancak proje teklifleri yeni işler için olmalıdır (bakım çalışması, revizyon veya mevcut belgelere yapılan yükseltmeler dahil). Tamamlanmış bir çalışma için ödeme yapmak üzere hibe başvurusunda bulunamazsınız.
Kuruluşum, teknik öğrenci yazarlarıyla çalışabilir mi?
Projenizde öğrencilerin teknik yazarlarının çalışmasını isteyebilirsiniz. Öğrencilerle çalışmayı tercih ediyorsanız, katılımı şu niteliklere sahip öğrencilerle sınırlamanızı kesinlikle öneririz:
- 18 yaşından büyük kullanıcılar
- Teknik yazı veya teknik iletişim programına ya da kursa kayıtlı olmak
- Programları veya kursları aracılığıyla teknik yazarlık koçluğuna erişilebilirliği kanıtlanabilir
Kuruluşum birden fazla teknik yazarla çalışabilir mi?
Kuruluşunuz birden fazla teknik yazar seçip ödeme yapabilir ancak kuruluşunuzla çalışan tüm teknik yazarlar, önerdiğiniz projede çalışmalıdır. Birden fazla teknik yazarla çalışmak projenizi daha karmaşık hale getirir, ayrıca daha fazla gönüllü çalışma ve yönetim süresi gerektirir.
Kuruluşum projemizde çalışmak üzere bir teknik yazarlık şirketiyle anlaşabilir mi?
Evet, kuruluşunuz projeniz üzerinde çalışmak üzere bir teknik yazı şirketiyle anlaşabilir. İşe aldığınız şirketin OpenCollective üzerinden ödeme alabildiğinden emin olun.
Teknik yazarımız program bitmeden programdan ayrıldı. Kuruluşumuz kalan ödemeleri almaya devam ediyor mu?
Projelere, program bitmeden önce projenizi tamamlayacak yeni bir yazar bulmayı denemeniz önemle tavsiye edilir. Bununla birlikte, kalan fonların ödemesi projenin tamamlanmasına değil, örnek olayın tamamlanmasına ve nihai değerlendirmenin tamamlanmasına bağlıdır.
Projeniz tamamlanamadıysa örnek olayınızda bunun nedeni incelenmelidir. Örneğin, belgeleme araçlarınızın çok karmaşık olduğunu ve teknik yazarlara çalışmaya başlamanın önünde bir engel olduğunu veya projenizin testler ile eğiticileri güncellemeyi gerektirdiğini ve kapsamlı kodlama deneyimi gerektirdiğini fark etmiş olabilirsiniz. Deneyiminize dayanarak diğer projelere ne önerirsiniz? Bu bilgileri örnek olayınıza ekleyin.
Kurumsal başvurular, son gönderim tarihinden önce incelenebilir mi?
Maalesef Google Dokümanlar'ın Google Sezonu kuruluş başvurusu hakkında geri bildirim sağlayamıyor.
Kurumlar proje tekliflerinin kapsamını nasıl belirlemelidir?
Proje fikirleri geliştirirken, kuruma değer sağlayacak en küçük projeleri bulmaya çalışın (ancak zaman kalırsa bu proje genişletilebilir). Ne kadar küçükse o kadar iyidir. Proje teklifinizi hazırlarken daha az ayrıntının olduğu, daha büyük projeler yerine daha küçük ve ayrıntılı projelere bağlı kalmanızı öneririz. Projeniz çok fazla alan uzmanlığı gerektiriyorsa bu arka plana sahip olmayan birinin üzerinde çalışabileceği projeler eklemeyi deneyin.
Google Dokümanlar Sezonu'na kuruluş yöneticisi olarak ve Google Summer of Code'a mentor olarak katılabilir miyim?
Evet. Google Dokümanlar Sezonu ve Google Kod Yazısı ayrı programlardır. Her iki programa da katılmak için gereken bant genişliğine sahipseniz sorun değil.
Kuruluşumuz önceki Google Dokümanlar Sezonu programlarına katılmıştı. Kuruluşumuz tekrar başvuruda bulunabilir mi?
Evet, önceki Google Dokümanlar Sezonu programlarına katılmış olan kuruluşlar tekrar başvurabilir.
Arşivlenen veriler
Google Dokümanlar Sezonu arşivinden bilgilerimi nasıl kaldırabilirim?
Bilgilerinizin kaldırılması için bize ulaşın.