Contributing

How we work

The NASA Openscapes Mentor Community is collaborating to create this Cookbook, with an eye towards how others could collaborate with us in the future.

The Openscapes Approach Guide describes how we work, including creating space and place, having a growth mindset, psychological safety, and continual learning, practice, and iteration. It also has our code of conduct and an overview of some of the workflows and tooling we use.

We believe open practices can accelerate data-driven solutions in science. These are critical to uncovering enduring science-based solutions faster, as well as for the well-being and resilience of research communities. We work towards kinder science.

Our style of working is greatly influenced by:

• The Turing Way Community Handbook
• The Carpentries Curriculum Development Handbook
• The Documentation System - by Daniele Procido/Divio; see image below!
• RStudio Cheatsheets
• eScience Hackweeks

The Earthdata Cloud Cookbook is made with Quarto with our 2i2c JupyterHub. Learn more in the Setup and Workflow sections.

Figure from documentation.divio.com: There is a secret that needs to be understood in order to write good software documentation: there isn't one thing called documentation, there are four. They are: tutorials, how-to guides, technical reference and explanation. They represent four different purposes or functions, and require four different approaches to their creation.

Notebook templates

To help contributors get started quickly, we provide starter templates for new notebooks. Each template includes the standard front matter, section structure, and code patterns used across the Cookbook.

• Python Jupyter Notebook Template - for .ipynb notebooks using Python
• Python Quarto Template - for .qmd documents using Python
• R Quarto Template - for .qmd documents using R

Copy the appropriate template into the relevant section of the Cookbook (e.g., how-tos or tutorials), and then edit it to add your content.