Questo spazio è dedicato agli utenti di Earth Engine che vogliono condividere le proprie conoscenze con il resto della community di Earth Engine. Creati dagli utenti di Earth Engine per gli utenti di Earth Engine, i tutorial di questa sezione sono pensati per tutti i livelli, dai principianti agli utenti più esperti.
I tutorial possono essere inviati come testo normale e codice formattato utilizzando il linguaggio di markup Markdown oppure come notebook Colab contenenti codice Python eseguibile e Markdown. I tutorial creati utilizzando le librerie client JavaScript di Earth Engine sono generalmente scritti in Markdown, mentre Colab è consigliato per i tutorial basati sulle librerie client Python di Earth Engine.
Prima di iniziare
Codice di condotta
Il team di Earth Engine si impegna a promuovere una community inclusiva e priva di vessazioni. Prima di contribuire, acquisisci familiarità con il nostro Codice di condotta.
Entrare a far parte di GitHub
I tutorial della community di Earth Engine vengono condivisi e rivisti tramite GitHub. Se non hai ancora un account GitHub, devi prima crearne uno all'indirizzo https://github.com/join.
Proporre un tutorial
Prima di investire tempo e risorse significativi in un nuovo tutorial, ai potenziali collaboratori viene chiesto di inviare una semplice proposta con alcune informazioni di base. In questo modo, gli autori possono collaborare con i manutentori della documentazione per sviluppatori di Earth Engine per concentrare gli sforzi sui tutorial che offrono il massimo valore alla community di utenti di Earth Engine. Inoltre, consente di risparmiare tempo evitando potenziali scambi di messaggi durante la procedura di revisione.
Prima configurazione
Se è la prima volta che invii un tutorial al repository GitHub della community di Earth Engine, assicurati di completare questi passaggi prima di iniziare a lavorare al tutorial:
Accetta il Contratto di licenza per i collaboratori (CLA) all'indirizzo:
https://cla.developers.google.com
Leggi e interiorizza la Guida di stile per i tutorial della community.
Scrivere e inviare un tutorial
Una volta accettata la tua proposta di tutorial dai manutentori, hai diverse opzioni per modificarlo e inviarlo al repository della community di Earth Engine:
Guida rapida a Markdown
Puoi creare un fork del repository GitHub e creare un nuovo tutorial direttamente tramite il sito web GitHub per iniziare rapidamente senza strumenti aggiuntivi o configurazione:
Se non l'hai ancora fatto, accedi a GitHub.
Per creare e modificare un nuovo file del tutorial, fai clic su Nuovo tutorial. Se necessario, ti verrà chiesto di creare un fork del repository.
Inserisci un nome per il file del tutorial del modulo:
your-tutorial-name/index.mdDove
your-tutorial-nameè il nome breve del tutorial in tutte le lettere minuscole. Utilizza i trattini ("-") per separare le parole. Non utilizzare spazi o altri segni di punteggiatura nel nome della cartella.Modifica il tutorial direttamente nell'editor di file GitHub utilizzando "Anteprima" per verificare l'output formattato (vedi anche Modifica dei file nel repository nella documentazione di GitHub).
Quando è tutto pronto, esegui il commit delle modifiche e apri una richiesta di pull.
notebook Colab
Fai clic qui per iniziare a scrivere un tutorial in Colab:
Si aprirà un notebook contenente le istruzioni per la creazione e l'invio del tutorial.
Avanzate
Se hai già familiarità con GitHub, git e strumenti correlati, la procedura generale è la stessa per l'invio di tutorial in Markdown e Colab:
Crea un fork e clona il repository GitHub google/earthengine-community.
Crea una directory in
tutorialscon il nome breve slugificato del tuo tutorial (ad es.tutorials/my-amazing-tutorial).Esegui il commit del tutorial nella nuova directory con il nome file
index.md(per Markdown) otutorial.ipynb(per Colab). Esegui il commit delle immagini utilizzate nel tutorial nella stessa directory.Trasferisci i nuovi contenuti nel tuo fork e apri una richiesta di pull.
Quando crei una richiesta di pull, assicurati di fare riferimento alla proposta originale tramite il codice problema di GitHub nella sezione dei commenti. Ad esempio, se il problema era #123, inserisci il testo "Closes #123" nella descrizione della richiesta di pull per fare riferimento alla proposta originale e per contrassegnarla automaticamente come completata una volta pubblicato il tutorial.
Una volta aperta una richiesta di pull, uno o più manutentori verranno assegnati alla revisione del tuo invio. Il revisore o i revisori collaboreranno con te per assicurarsi che la tua richiesta sia completa, corretta e coerente con la Guida di stile per i tutorial della community di Earth Engine.
Una volta approvata la pull request, il tutorial verrà pubblicato dai gestori del repository.