Sık sorulan sorular (SSS)

Mevcut aşama:
Dökümanlar Sezonu 2019 programı 6 Mart 2020'de sona erdi. Zaman çizelgesini inceleyin.

Genel

Sezon, Dokümanlar bir işe alım programı mı?

Hayır. Google için çalışmak istiyorsanız lütfen Google iş fırsatları web sitesini ziyaret edin.

Dokümanlar Dönemi bir staj, iş veya herhangi bir istihdam türü olarak kabul edilir mi?

Hayır. Dokümanlar Sezonu, teknik yazarların bağımsız teknik yazar olarak gerçekleştirdiği ve karşılığında ücret alınan bir aktivitedir. Teknik yazarlar bu ödülü almamayı tercih edebilir.

Dokümanlar Sezonu'na neden katılmalıyım?

Season of Docs'un hedefi, açık kaynak kuruluşlar ve teknik yazarlar arasında ortak çalışmayı teşvik etmektir. Bu programın şunları yapacağını düşünüyoruz:

  • Teknik yazarlara açık kaynak projelere katkıda bulunma ve açık kaynak kodu hakkında bilgi edinme deneyimi kazanma fırsatı verin.
  • Açık kaynak projelere teknik yazar topluluğunun ilgisini çekme ve böylece açık kaynak belgelerini iyileştirme fırsatı verin.
  • Açık kaynak dokümanlar ve teknik yazı konusunda farkındalık oluşturun.

Açık kaynak kuruluşlar için avantajlar:

  • Teknik yazarla çalışma deneyimi.
  • İyileştirilmiş dokümanlar.
  • Dokümanlar Sezonu sona erdikten sonra teknik yazarlarla sürekli iş birliği yapma potansiyeli.
  • Projelerinizi belgeleme süreçleri iyileştirildi.
  • Teknik yazarlık topluluğu arasında açık kaynak dokümanlara dair farkındalığın artması.

Teknik yazarlar için avantajlar:

  • Açık kaynak projelerine katkıda bulunma deneyimi.
  • Geliştirici odaklı belgelerle ve kodla çalışma deneyimi edinin.
  • Yapılan çalışmanın takdiri ve takdiri.
  • Öz geçmişinize ekleyebileceğiniz bir şey.
  • Dokümanlar Sezonu bittikten sonra açık kaynak projesiyle sürekli iş birliği yapma potansiyeli
  • Açık kaynak topluluklarında, teknik yazarların sağlayabileceği değere ilişkin farkındalığı artırdılar.

Teknik yazarlar ne tür projelerle ilgilenebilir?

Aşağıdaki önerilerden yararlanabilirsiniz:

  • Platformda teknik yazar ve açık kaynak mentorun karar vereceği bir belge sitesi oluşturun ve sitede ilk temel belge grubunu yayınlayın. Platformlara örnek olarak aşağıdakiler verilebilir:

  • Daha iyi bir kullanıcı deneyimi veya daha erişilebilir bir bilgi mimarisi sağlamak için açık kaynak projenin mevcut belgelerini yeniden düzenleyin.

  • Bir ürün veya özellik için kavramsal bir genel bakış ya da tanıtım yazın. Ekip genellikle aşağıdan yukarıya doğru teknik belgeleri oluşturur. Bunun sonucunda çok fazla ayrıntı vardır ama ürünü bir bütün olarak anlamak zordur. Teknik yazar bu sorunu düzeltebilir.

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

  • Belirli görevler için bir dizi odaklanmış "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, çekme istekleri ve yorumlar için süreçler, projenin oluşturulması vb. ile ilgili tüm kuralları içeren katkıda bulunanlar için bir kılavuz oluşturun.

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

Evet. Proje fikirlerini yayınlamak ve teknik yazar tarafından gönderilen proje teklifini seçmek açık kaynak kurumuna kalmıştır. Bir video açık kaynak kuruluşunun gereksinimlerini karşılıyorsa videoyu bir Dokümanlar Sezonu projesi olarak gönderebilirsiniz (teknik eğitim videosu olması şartıyla). Video gereksinimlerinin iyi geniş bir kapsama sahip olduğundan emin olun ve yüksek kaliteli video üretmek için zaman ve kaynak gerektiğini unutmayın.

Mentorluk kuruluşlarının teknik yazarlar tarafından hazırlanan belgeleri kullanması zorunlu mu?

Hayır. Bu programdan çıkan tüm belge ve kodların sizi mutlu edeceğini ümit etse de kuruluşlardan teknik yazarların belgelerini veya kodlarını kullanmalarını zorunlu tutmuyoruz.

Dokümanlar Mevsimi nerede gerçekleşir?

Dokümanlar sezonu tamamen çevrimiçi olarak gerçekleşir. Program kapsamında seyahat yapılması şart değildir.

Dokümanlar Dönemi'nden nasıl haberdar olabilirim?

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

Dokümanlar Mevsimi'ni duyurmak için ne yapabilirim?

Program hakkında tweet gönderebilir, 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.

Dokümanlar Sezonu bilgi oturumu veya buluşmasını nasıl düzenleyebilir ya da düzenleyebilirim?

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

Dokümanlar Sezonu'na hem mentor hem de teknik yazar olarak katılabilir miyim?

Hayır. Projeye ve teknik yazara yeterince ilgi gösterilmesini istiyoruz ve bunun projeye dahil olanlar için kötü bir deneyim yaratabileceğini düşünüyoruz. Lütfen mentor olarak mı yoksa teknik yazar olarak mı katılımın sizin için daha uygun olduğunu seçin ve buna göre başvuru yapmayı planlayın.

Mevsimlik Dokümanlar Tişörtü alacak mıyım?

Evet. Başarıyla tamamlanan projelerdeki katılımcılara Sezon Dokümanlar Tişörtü verilir. Bu yılın tişörtü ilk program Tişörtü olacak.

Tişörüm ne zaman gelecek?

COVID-19 salgını nedeniyle şu anda tişörtünüzü ne zaman teslim alacağınıza dair tahmini bir bilgi veremiyoruz. Google, tişörtleri üretmesi ve dünyanın her yerine ürün gönderiminin lojistiğini halletmesi için bir tedarikçiyle anlaştı. Üretim mümkün olduğunda Google program yöneticileri, tişört stilinizi/bedeninizi seçmeniz ve kargo bilgilerinizi girmeniz için size e-posta ile benzersiz bir erişim kodu gönderir. Tişörtlerin üretimi ve gönderimi genellikle birkaç hafta sürer.

Başka sorularım varsa ne yapmam gerekir?

Teknik yazar kılavuzu, danışman rehberi ve kuruluş yöneticisi kılavuzuna göz atın.

Tüm dokümanları okuduktan sonra hâlâ bir yanıt bulamadıysanız lütfen sorularınızı Slack'te Season of Docs topluluğu veya tartışma listesi ile tartışmayı düşünün. Tartışma kanalları ve bizimle iletişime geçme ile ilgili bilgilere göz atın.

Teknik yazarlar için

Teknik yazarlar Dokümanlar Sezonu için ne zaman başvurabilir?

Teknik yazar başvuru aşaması 29 Mayıs 2019 - 28 Haziran 2019 tarihleri arasında gerçekleşecektir. Program zaman çizelgesine ve teknik yazar kılavuzuna bakın.

Dokümanlar Dönemi'ne katılmak için hangi belge araçlarını ve çerçevelerini bilmem gerekir?

Kullanacağınız belgeleme araçları ve çerçeveler, çalışmak istediğiniz kuruluşa göre değişir. Belgeler Sezonu'nun bir parçası da, teknik yazarların açık kaynak ürünleri belgelemede kullanılan araçlar ve çerçeveler hakkında daha fazla bilgi edinmesine yardımcı olacak açık kaynak projeleri oluşturmaktır. Bu nedenle, Dokümanlar Mevsimi projenize başlamadan önce genellikle belirli belge platformları hakkında ayrıntılı bilgiye sahip olmanız gerekmez.

Bununla birlikte, çoğu açık kaynak kuruluşu belgeleri için belirli bir Markdown aroması veya başka bir işaretleme dili kullanır. Seçtiğiniz kuruluşun hangi dili kullandığını öğrenmenizi ve söz dizimine aşina olmanızı öneririz. GitHub README dosyaları Markdown'ın bir türünü kullandığından Markdown iyi bir başlangıçtır. GitHub kılavuzunu inceleyerek Markdown'a göz atın.

Seçtiğiniz kuruluşun belgelerini bir web sitesinde zaten 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şturma aracı olabilir ya da kuruluş, dokümanlarını Dokümanlar'ı okuyun veya GitHub Sayfaları'nda barındırabilir. Platform organizasyonunun 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şlayabilir ve seçtiğiniz açık kaynak projesine sağlam tavsiyelerde bulunabilirsiniz.

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

Belgeleme projenizin türüne bağlı olarak bir programlama diline aşina olmanız gerekebilir. Bir belgeleme projesi seçerken ve önerirken bu durumu göz önünde bulundurun ve gerekli bilgi düzeyi konusunda açık kaynak kurumuna danışın.

Birden fazla proje teklifi gönderebilir miyim?

Evet, ancak her teknik yazar başına yalnızca bir proje teklifi kabul edilir. Uygulamanızı oluşturma kılavuzuna bakın.

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

Evet, ancak teklifinizde projeyle önceki ilişkinizi belirtmelisiniz.

Bir grup, tek bir proje üzerinde çalışmak için birlikte teklif gönderebilir mi?

Hayır, belli bir projede yalnızca bir kişi çalışabilir.

Sezon Dokümanları'na teklif göndermeden önce mentorluk organizasyonlarıyla doğrudan iletişime geçebilir miyim?

Evet, Dokümanlar Sezonu başvurunuzu göndermeden önce, birlikte çalışmak istediğiniz açık kaynak kuruluşuyla doğrudan iletişim kurabilirsiniz. Açık kaynak mentorlar proje fikrinizi geliştirmenize yardımcı olabilir.

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

  • Kaydolurken en az 18 yaşında olmanız gerekir.
  • Program süresince ikamet edeceğiniz ülkede çalışmaya uygun olmanız gerekir.
  • Şu anda ABD tarafından ambargo uygulanmayan bir ülkede ikamet etmeniz gerekir. ABD Hazinesi'nden program kuralları ile Yaptırım Programları ve Ülke Bilgileri'ni inceleyin.

Uygunluk koşullarında benim için bir istisna yapar mısınız?

Hayır. Ne kadar yetenekli veya ilgili olursanız olun uygunluk koşullarını karşılamıyorsanız istisna uygulayamayız. Sizin için istisna yapmak, Dokümanlar Mevsimi'ne katılım için başvuran diğer teknik yazarlara adil olmaz.

Hangi formları sağlamam gerekiyor?

Kabul edilen katılımcıların uygun vergi formlarını sağlaması gerekir.

Teknik yazar olarak önceden deneyime veya eğitime ihtiyacım var mı?

Daha önce teknik yazı yazma deneyimi veya eğitim almış olmak tercih edilir ancak gerekli değildir. Proje teklifi gönderirken deneyiminizi ve/veya eğitiminizi teknik yazılı olarak açıklayabilirsiniz. Kendi yazdığınız belge örnekleri dahil olmak üzere, teknik belgelere veya açık kaynaklı belgelere gösterdiğiniz ilgiyi gösteren bazı kanıtlar sunabilmeniz gerekir. Sezon Dokümanları programı, deneyimli veya eğitimli teknik yazarlarla açık kaynak danışmanlarla iş ortaklığı kurmayı ve böylece her birinin birbirinden bilgi edinmesini amaçlamaktadır. Açık kaynak kuruluşu, Dokümanlar Dönemi projelerini başarıyla tamamlamak için kuruluşun ihtiyaç duyduğu deneyim düzeyinde teknik yazarlar arar.

Dokümanlar Dönemi'ne katıldığım için ödeme alacak mıyım?

Evet. Google, programı başarıyla tamamlayan teknik yazarlara burs verecektir. Bursu almamayı tercih edebilirsiniz. Teknik yazar ücreti ile ilgili ayrıntıları inceleyin.

Kuruluş dokümanlarımı veya kodumu kullanmasa bile ödeme alacak mıyım?

Evet, projenizin açık kaynak danışmanının son değerlendirmesini geçmesi gerekir. Açık kaynak projesinin üretilen dokümanları veya kodu kullanıp kullanmaması, teknik yazarlık ücretinin ödemesini etkilemez.

İyi bir teknik yazar teklifi nasıl olur?

En iyi teklifler, Dokümanlar Sezonu başvurularını göndermeden önce, seçtikleri açık kaynak kuruluşla etkileşime geçmeye ve fikirlerini tartışmaya zaman ayıran teknik yazarlar olacaktır. Uygulamanızı oluşturma ile ilgili kılavuza bakın.

Dokümanlar Sezonu'na katılım ne kadar sürer?

Harcadığınız zaman, mentor kuruluşunuzla ilgili anlaştığınız projenin niteliğine bağlıdır. Saat sayısı şartı, farklı proje türlerine ve farklı çalışma tarzlarına olanak tanımak için kasıtlı olarak esnektir.

Proje teklifinizi göndermeden önce projeyi değerlendirmeniz ve açık kaynak olan kurumla süre tahminini tartışmanız gerekir. Kararlaştırılan süreyi diğer taahhütler nedeniyle harcamakta zorlanıyorsanız projeyi daha uzun bir sürede tamamlayabilme ve yine de ücreti ve yapılan çalışmanın onayını alma seçeneğiniz vardır. Season of Docs başvurunuzu gönderirken, uzun süreli bir proje seçeneğini belirtin.

Teknik iletişim eğitimi alıyorum ancak henüz iş tecrübem yok. Yine de katılabilir miyim?

Evet. Proje teklifinizi gönderirken önceki iş deneyimleriniz için bu bölümde üniversitenizi veya üniversite kurslarınızı listeleyin.

Amerika Birleşik Devletleri'nde F1 vizesi kabul edilen bir öğrenciyim. Katılım yetkilendirmesini nasıl alabilirim?

Daha fazla bilgi için lütfen okulunuzun uluslararası öğrenci işleri ofisiyle görüşün. Google, size herhangi bir CPT veya OPT yetkilendirmesi sağlayamaz.

Kabul edilen tüm katılımcılara, kabul ettiklerine dair bir e-posta onayı gönderilir. Özelleştirilmiş harfler sunmuyoruz.

Season of Docs başvuru formumdaki bilgileri nasıl kullanır?

Google program yöneticileri, başvurunuzdaki bilgilerin bir kısmını seçtiğiniz açık kaynak kuruluşunun yöneticilerine iletir. Böylece kurum, proje teklifinizi değerlendirebilir.

Projeniz programa kabul edilirse Sezona ait Dokümanlar, proje ayrıntılarını web sitesinde yayınlar.

Teknik yazar başvuru formu kılavuzunda veri kullanımı açıklamasına bakın.

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

Dokümanlar Sezonu'na mentor olarak katılma hakkında daha fazla bilgi edinmek istiyorum. Nereden daha fazla bilgi edinebilirim?

Dokümanlar Sezonu mentoru olma hakkında daha fazla bilgi edinmek için danışman kılavuzunu ve program kurallarını okuyun.

Mentorluk yapan bir kurum için uygunluk koşulları nelerdir?

Mentorluk kuruluşu olarak katılmaya uygun olmak için BRL-CAD gibi etkin bir ücretsiz/açık kaynak yazılım projesini yürüten bir grup olmanız gerekir. Projenin yasal olarak tüzel kişiye ait olması gerekmez. Mentorluk kuruluşlarının, programa katılabilmeleri için Açık Kaynak İnisiyatifi onaylı lisans kapsamında yazılım üretip yayınlamış olmaları ve tüm Dokümanlar sezonu boyunca kuruluş yöneticisi ve/veya mentor olarak görev yapacak en az iki katkıda bulunanı olması 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 bakın.

Kuruluşlar Dokümanlar Sezonu'na katılım için herhangi bir para alıyor mu?

İyi durumdaki kuruluşlar, programın sonunda, kabul edilen teknik yazar başına ücret alır. Bu, teknik yazarın projesinin başarılı olup olmamasından bağımsızdır. Kuruluşlar bu fonları diledikleri gibi kullanmakta özgürdür.

Google program yöneticileri teknik yazarlık projeleri için alanları nasıl paylaştırır?

Dokümanlar Sezonu 2019 pilot programında toplamda en fazla 50 teknik yazı projesi yer alabilir.

Kabul edilen proje sayısının çok fazla olmaması için kılavuz olarak, kuruluş başına en fazla 2 proje kabul etmeyi umuyoruz. Bununla birlikte, ücretsiz seçim işlemi tüm slotları dolduramazsa Google program yöneticileri bazı kuruluşlara ek slotlar atayabilir.

Bu nedenle, seçtiğiniz teknik yazı projelerini gönderirken 2'den fazla proje seçebilirsiniz. Seçimlerinizi, en yüksek önceliğiniz listenin en üstünde olacak şekilde, öncelik sırasına göre listelediğinizden emin olun.

Teknik yazarlarla iletişimlerinizde, Google program yöneticileri kabul edilen projelerin listesini programın web sitesinde yayınlayana kadar projenin kabul edilmediğini açıkça belirtmeniz gerekir.

Season of Docs'a hem kuruluş yöneticisi hem de mentor olarak katılabilir miyim?

Evet. Kuruluş yöneticisi de mentor olabilir. Ayrı bir mentor formu doldurmanız gerekmez. Kuruluş başvuru formunu veya alternatif yönetici formunu doldururken aynı zamanda mentor olarak hareket ettiğinizi belirtmek için bu formdaki seçeneği kullanmanız gerekir.

Hem Season of Docs hem de Google Summer of Code'a kuruluş yöneticisi veya mentor olarak katılabilir miyim?

Evet. Dokümanlar sezonu ve Google Summer of Code ayrı programlardır. Her iki programa da katılmak için gereken bant genişliğine sahipseniz sorun yoktur.

Hem Dokümanlar Dönemi'nde hem de Google Code-in'de kuruluş yöneticisi veya mentor olarak katılabilir miyim?

Evet. Dokümanlar dönemi ve Google Code-in ayrı programlardır. Her iki programa da katılmak için gereken bant genişliğine sahipseniz sorun yoktur.

Arşivlenen veriler

Dokümanlarım Sezonu arşivinden bilgilerimi nasıl kaldırabilirim?

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