İş Ürünü Gönderim Yönergeleri

Son değerlendirmede, katkıda bulunan tüm katılımcıların program için yaptıkları çalışmanın bağlantısını vermeleri gerekir. Bu işlemin düzgün şekilde yapılmaması programda başarısızlığa yol açabilir. Bunu yapmanın birkaç farklı yolu vardır. Lütfen bu belgeyi dikkatle okuyun.

Bu bağlantılar GSoC projelerinin herkese açık arşivinde yayınlanır. Program sırasında yapılan çalışmaları göstermeye yardımcı olurlar. Ayrıca, gelecekteki işverenlerinize çalışmalarınıza tekrar göz atabilmeniz için de harika bir yöntemdir. İnsanların proje hedeflerinizin ne olduğunu, neler başardığınızı, kodunuzun nerede olduğunu ve sonraki olası adımları hızlıca anlayabilmesini istiyorsunuz.

Geçtiğimiz yıllarda gördüğümüz en iyi örnekler, aşağıdakileri içeren bir "nihai rapor" gibi görünür:

  • Proje hedeflerinin kısa bir açıklaması.
  • Yaptıklarınız
  • Geçerli durum.
  • Yapmanız gereken diğer şeyler.
  • Yayın öncesi hangi kodun birleştirildiğini (veya hangilerinin kaldırılmadığını) gösterir.
  • Proje sırasında öğrendiğiniz zorluklar veya önemli şeyler.

Örneklere bakmak için 2022 Proje Listesi'ne gidin, projeleri rastgele seçin ve ardından KODU GÖRÜNTÜLE'yi tıklayın. Bu projelerin birçoğunun önerilerimize uymadığını ve bu yüzden sadece çalışmalarını gösterebilmek için onlara zarar verdiğini unutmayın.

KURULUŞ İÇİN NOT: Gönderiminizin son halini gönderdikten sonra, çalışmanızı son teslim tarihine kadar düzenleyebilirsiniz.

Bağlantınızı değerlendirmenizi göndermeden ÖNCE mentorunuzla paylaşmalı, beklentilerini karşıladığından emin olmalısınız.

Koşullar

  • Yaptığınız iş kolayca ayırt edilebilmelidir. (yani yaptığınız değişiklikler veya yeni kod.)
    • Bir kullanıcı sağlanan URL'ye gittiğinde, çok fazla araştırma yapmasına gerek kalmadan ne yaptığınızın açık bir şekilde anlaşılabilmesi gerekir.
  • Sabit bir konumda olmalıdır. URL, gönderimden sonra değiştirilemez.
  • Çalışmanızı genişletmek için bağlantının hedefindeki (veya referans verilen) içeriği başka bir kişi kullanabilir.
    • Çalışmanız% 100 tamamlanmışsa ilgili kişi tarafından kullanılabilir.
    • İşiniz% 100 tamamlanmamışsa yapılması gerekenlerin açık olması gerekir.

Doğru Örnekler

Bunların tümünü (veya herhangi birini) yapmanız gerekmez, ancak bu gereksinimleri karşılayabileceğiniz bazı yöntemler aşağıda verilmiştir.

  • Yaptığınız çalışmaları açıklayan bir blog yayını veya web sayfası ya da herkese açık bir GitHub gist'i oluşturun. Ayrıca, yaptığınız taahhütlerin ve üzerinde çalıştığınız depoların bağlantılarını ekleyin. Proje üzerinde hâlâ yapılacak işler varsa bunları da ekleyin. Öne çıkan veya zorlayıcı kısımları da paylaşabilirsiniz.
    • ❗ Bu en iyi seçenektir çünkü kolayca çok fazla bilgi eklemenize olanak sağlar. Bu, hangi işlemi yaptığınızı net bir şekilde gösterdiğinden ve başkalarının kodunuzu kullanmasını ve anlamasını kolaylaştırdığından faydalıdır.
  • GitHub kullanıyorsanız ve tüm çalışmanız tek bir pull isteği kapsamındaysa bu bağlantıyı kullanabilirsiniz.
    • Pull isteği açıklamasının ayrıntılı olduğundan emin olun. (Yukarıdaki blog yayını içeriği önerilerine bakın.)
    • Açıklamada, bunun Google Summer of Code için olduğu açıkça belirtilmelidir.
    • GSoC bittikten sonra pull isteği daha fazla iş yapacaksa son GSoC taahhüdünün not edildiğinden emin olun.
    • ❗ Bu örnekte değişiklik günlüğü, taahhütler listesi ve yorum yorumlarının tamamını tek bir yerde bulundurma avantajı bulunmaktadır.
  • GitHub deponuz GSoC için tek amaçlıysa daha fazla ayrıntı içeren bir README.md ekleyin.
  • Herkese açık olarak arşivlenmiş geliştirici posta listesine yukarıdakileri içeren bir e-posta gönderin ve bu listenin bağlantısını da gönderin.
  • Google Drive'da bir ortak klasör oluşturun ve oluşturduğunuz tüm yamaları dahil edin.
  • Google E-Tablolar ile herkese açık bir e-tablo oluşturun ve tüm kayıtlarınızı listeleyin.
  • Çalışmaya ve ilgili diğer her türlü unsuru açık bir şekilde içeren tek bir hataya bağlantı verin. Yaptığınız tüm işleri izlemelidir. Tüm kayıtların listelendiğinden veya başka şekilde kolayca bulunabildiğinden emin olun.
  • Değişikliklerinizin birleştirilmiş veya bağlam farkına bağlantı verin. Projenin hangi proje için, kim olduğunu belirten bir başlık eklediğinizden emin olun. Böylece başkaları için faydalı olur.

Hatalı Örnekler

Bunları yapma.

  • Projenin kaynak kodunun tamamını veya çalışma dizininizi içeren bir tarball/zip dosyasına bağlantı oluşturun. (Bunu geçmişte yapan çok fazla kişi vardır ve bu, yaptıklarınızı daha fazla anlamak isteyenler için faydalı değildir.)
  • Projenin birincil kaynak deposunun üst kısmına bağlantı.
  • Projenizin kaynak deposu klonunuza bağlanın.
    • Çalışmanız başka kişilerle karıştırıldığı için bu durum, yaptığınız değişikliklerin ne olduğunu görmenizi zorlaştırır.
  • GSoC proje sayfanızın bağlantısı.
    • Bunun ne olduğunu zaten biliyoruz. (https://summerofcode.withgoogle.com/projects/#1234567890)

Mentorlar

Lütfen katkıda bulunan kullanıcının uygun bir kod göndermesine yardımcı olun. Bu işlemi, çalışmanın son gönderim tarihinden önce yapmak önemlidir.

Şunları kontrol edin...

  • Gönderiminiz yukarıdaki şartları karşılıyor.
  • Kod derlenir.
  • Ne ve neden olduğuyla ilgili belgeler var.

GSoC'nin amacı, katkıda bulunanların kodu bırakması değildir. Kodun, barındıran Açık Kaynak projesi için potansiyel olarak yararlı olması önemlidir.