Community Tutorial Style Guide

Stay organized with collections Save and categorize content based on your preferences.


This guide provides general guidelines for writing your own Google Earth Engine tutorials. It aims to make it easy to create high-quality tutorials that are clear, concise, and easily understood by the entire Earth Engine community.

The tutorial templates below double as an additional guide to help kickstart your own tutorials. Details on how to use the templates to get started can be found in Writing a Tutorial.

In addition, the Google Cloud Platform Community Tutorial Style Guide provides a valuable reference for writing end-to-end tutorials for a broad audience, while the Google JavaScript Style Guide details the recommended style for use in JavaScript code samples. Reviewers may refer to these guides when reviewing your submission.

General guidelines

  • Be brief.
  • Don't repeat yourself.
    • Don't say the same thing twice (even if worded differently).
  • Periodically mark progress.
    • Include images and text at key points in the tutorial so the user knows they're on track. Use sparingly!
  • Use the active voice whenever possible.
    • "When the user changes the value", not "when the value is changed".
    • Exception: It's okay to use passive voice when you'd have to go out of your way to use active voice, or if the actor is obvious or not relevant ("an animated GIF is returned" instead of "Earth Engine returns an animated GIF").
  • Stick to the facts.
    • Avoid superlatives ("this is 100% the best and fastest method").
    • Avoid promoting products or services.
    • Avoid controversial topics.
    • Include citations and URLs when referencing specific methods, datasets, and analyses.
  • Make your tutorial self-contained.
    • Try not to rely on special libraries outside the API or datasets not in the public Earth Engine Data Catalog.
    • If you're providing additional data or algorithms, only share them if you have permission to do so. Include all required licenses and attributions.
  • Test your code.
    • Be sure to run and test all included code samples right before submitting your article for review.

Tutorial templates


If you're already familiar with git and GitHub, you may use the code below as a template to get you started:

title: Your tutorial title
description: A short description of the tutorial, all on one line with no carriage returns.
author: your-github-username
tags: comma-separated, lowercase, list, of, related, keywords
date_published: YYYY-MM-DD
Copyright 2022 The Google Earth Engine Community Authors

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.

In a few sentences, describe what the user is going to learn. Be sure to include
_concise_ background information; only include what's helpful and relevant.
When in doubt, leave it out!

## Section heading 1

Break up your tutorial into manageable sections.

With one or more paragraphs, separated by a blank line.

Inside your sections, you can also:

1. Use numbered lists
1. ..when the order..
1. ..of items is important.


- This is a bulleted list.
- Use bulleted lists when items are not strictly ordered.

..and even:

Use     | tables   | to organize | content
------- | -------- | ----------- | -------
Your    | tables   | can         | also
contain | multiple | rows        | ...

## Section heading 2

Use separate sections for related, but discrete, groups of steps.

Use code blocks to show users how to do something after describing it:

// Use comments to describe details that can't be easily expressed in code.
// Always try making code more self descriptive before adding a comment.
// Similarly, avoid repeating verbatim what's already said in code
// (e.g., "assign ImageCollection to variable 'coll'").
var coll = ee.ImageCollection('LANDSAT/LC08/C01/T1_TOA');

### Use subsections if appropriate

Consider breaking longer sections that cover multiple topics or span multiple
pages into subsections.

Alternatively, the above template can be opened directly in GitHub's web based file editor by following instructions at Writing a Tutorial.

Be sure to also refer to Writing a Tutorial for important details on the proposal, authoring, and submission process.


To create a new Colab notebook using the recommended style template, click here:

New Colab tutorial

This will open a notebook containing instructions for authoring and submitting your tutorial. Be sure to refer to Writing a Tutorial for important details on the proposal, authoring, and submission process.