İlk topluluk eğitiminizi yazma

Bu alan, bilgilerini Earth Engine topluluğunun geri kalanıyla paylaşmak isteyen Earth Engine kullanıcılarına ayrılmıştır. Bu bölümdeki eğitimler, Earth Engine kullanıcıları tarafından Earth Engine kullanıcıları için oluşturulmuştur. Başlangıç seviyesinden daha ileri seviyeye kadar tüm kullanıcılar bu eğitimlerden yararlanabilir.

Eğitici içerikler, düz metin olarak ve Markdown biçimlendirme dili kullanılarak biçimlendirilmiş kod olarak ya da Markdown ve çalıştırılabilir Python kodu içeren Colab not defterleri olarak gönderilebilir. Earth Engine JavaScript istemci kitaplıkları kullanılarak oluşturulan eğitimler genellikle Markdown ile yazılırken Earth Engine Python istemci kitaplıklarına dayalı eğitimler için Colab önerilir.

Başlamadan önce

Davranış Kuralları

Earth Engine ekibi, taciz içermeyen ve herkesi kucaklayan bir topluluk oluşturmaya kararlıdır. Lütfen katkıda bulunmadan önce Davranış Kurallarımızı inceleyin.

GitHub'a katılma

Earth Engine topluluğu tarafından hazırlanan eğitimler GitHub üzerinden paylaşılır ve incelenir. GitHub hesabınız yoksa önce https://github.com/join adresinden hesap oluşturmanız gerekir.

Eğitim önerisinde bulunma

Yeni bir eğitime önemli ölçüde zaman ve emek harcamadan önce, potansiyel katkıda bulunanlardan bazı temel bilgileri içeren basit bir teklif göndermeleri istenir. Bu sayede yazarlar, Earth Engine geliştirici dokümanlarının bakımını yapan kişilerle birlikte çalışarak Earth Engine kullanıcı topluluğuna en fazla değeri sağlayan eğitimlere odaklanabilir. Ayrıca inceleme sürecinde olası ileri geri iletişimleri önleyerek zamandan tasarruf sağlar.

Eğitim önerin

İlk kurulum

Earth Engine topluluğu GitHub deposuna ilk kez eğitim gönderiyorsanız eğitiminiz üzerinde çalışmaya başlamadan önce aşağıdaki adımları tamamladığınızdan emin olun:

  1. Katkıda Bulunan Lisans Sözleşmesi'ni (CLA) şu adreste kabul edin:

    https://cla.developers.google.com

  2. Topluluk Eğitimi Stil Rehberi'ni okuyup benimseyin.

Eğitim yazma ve gönderme

Eğitim öneriniz geliştiriciler tarafından kabul edildikten sonra eğitimi düzenlemek ve Earth Engine topluluk deposuna göndermek için çeşitli seçenekleriniz olur:

Markdown'a hızlı başlangıç

Ek araçlar veya kurulum olmadan hızlı bir şekilde başlamak için GitHub deposunu çatallayabilir ve doğrudan GitHub web sitesi üzerinden yeni bir eğitim oluşturabilirsiniz:

  1. Henüz yapmadıysanız GitHub'da oturum açın.

  2. Yeni bir eğitim dosyası oluşturmak ve düzenlemek için Yeni eğitim'i tıklayın. Gerekirse kod deposunu çatallamanız istenir.

    Yeni eğitim

  3. Formun eğitim dosyası için bir ad girin:

    your-tutorial-name/index.md

    Burada your-tutorial-name, eğitiminize ait kısa adın tümü küçük harflerle yazılmış halidir. Kelimeleri ayırmak için kısa çizgi ("-") kullanın. Klasör adında boşluk veya başka bir noktalama işareti kullanmayın.

  4. Biçimlendirilmiş çıktıyı doğrulamak için "Önizleme"yi kullanarak eğitiminizi doğrudan GitHub dosya düzenleyicisinde düzenleyin (GitHub dokümanlarındaki Deponuzdaki dosyaları düzenleme bölümüne de bakın).

  5. Hazır olduğunuzda değişikliklerinizi işleyin ve pull isteği açın.

Colab not defteri

Colab'da eğitim yazmaya başlamak için burayı tıklayın:

Yeni Colab eğitimi

Bu işlemle, eğitiminizi oluşturma ve göndermeyle ilgili talimatların yer aldığı bir not defteri açılır.

Gelişmiş

GitHub, git ve ilgili araçlara aşinaysanız hem Markdown hem de Colab eğitimlerini gönderme süreci aynıdır:

  1. google/earthengine-community GitHub deposunu çatallayıp kopyalayın.

  2. tutorials altında, eğitiminize ait slugified kısa adla bir dizin oluşturun (ör. tutorials/my-amazing-tutorial).

  3. Markdown veya Colab için uygun başlığı ekleyin.

  4. Eğitimi, index.md (Markdown için) veya tutorial.ipynb (Colab için) dosya adıyla yeni dizine kaydedin. Eğitimde kullanılan resimleri aynı dizine kaydedin.

  5. Yeni içeriği çatallamanıza aktarın ve çekme isteği açın.

Pull isteği oluştururken yorum bölümünde GitHub sorun numarasıyla orijinal öneriye referans verdiğinizden emin olun. Örneğin, sorun #123 ise orijinal öneriye referans vermek ve eğitim yayınlandıktan sonra otomatik olarak tamamlandı olarak işaretlemek için pull isteği açıklamasına "Closes #123" metnini yerleştirirsiniz.

Çekme isteği açtıktan sonra, gönderiminizi incelemek için bir veya daha fazla bakımcı atanır. İncelemeyi yapanlar, gönderiminizin eksiksiz ve doğru olduğundan ve Earth Engine Topluluğu Eğitim Stili Rehberi ile tutarlı olduğundan emin olmak için sizinle birlikte çalışır.

Çekme isteğiniz onaylandıktan sonra eğitiminiz, depo yöneticileri tarafından yayınlanır.