Contributing

Summary

This page provides guidance for contributors to the NEMO Cookbook.

Contributing to NEMO Cookbook

Thank you for your interest in contributing to NEMO Cookbook!

We welcome contributions from the community to help improve the reproducible analysis of NEMO outputs.

Getting Started

To get started with contributing to NEMO Cookbook, please follow the steps below:

Fork the NEMO Cookbook repository on GitHub.
Clone your forked repository to your local machine.
Create a new branch for your contribution.
Add your new recipe or improvements to the codebase.
Follow the NumPy docstring conventions when adding or modifying docstrings.
Follow the PEP 8 style guide when writing code.
Test your changes thoroughly to ensure they work as expected.
Commit your changes with clear and descriptive commit messages.
Push your changes to your forked repository.
Submit a pull request to the main branch of NEMO Cookbook.

Code Guidelines

When contributing code to NEMO Cookbook, please adhere to the following guidelines:

Follow the coding style and conventions used in the existing codebase.
Write clear and concise code with appropriate comments.
Ensure your code is well-tested and does not introduce any regressions.
Make sure your recipe is scalable using dask.
Add a new .ipynb demonstrating your new recipe.
Document any new features or changes in the appropriate sections of the documentation.

Bug Reports and Feature Requests

If you find any bugs or have ideas for new features, please open an issue on the NEMO Cookbook GitHub repository.

Provide as much detail as possible, including steps to reproduce the issue or a clear description of the desired feature.

Community Guidelines

When participating in the NEMO Cookbook community, please be respectful and considerate towards others. Follow the code of conduct and engage in constructive discussions.

We appreciate your contributions and look forward to working together to improve NEMO Cookbook!