Skip to content

Latest commit

 

History

History
94 lines (67 loc) · 4.47 KB

CONTRIBUTING.md

File metadata and controls

94 lines (67 loc) · 4.47 KB
Raw

Contributing Guidelines

We accept different types of contributions, including some that don't require you to write a single line of code.

📣 Discussions

Discussions are where we have conversations.

If have a great new idea, or want to share something amazing with the community, join us in discussions.

🐞 Issues

Issues are used to track tasks that contributors can help with.

If you've found something in the content or the website that should be updated, search open issues to see if someone else has reported the same thing. If it's something new, open an issue! We'll use the issue to have a conversation about the problem you want to fix.

🛠️ Pull requests

A pull request is a way to suggest changes in our repository.

When we merge those changes, they should be deployed to the live site within a few minutes. :earth_africa: To learn more about opening a pull request in this repo, see Opening a pull request below.

🌏 Translations

APECS is an international organization with people from across the world. The source content in this repository is written in English.

We do not yet have any translated content, but hope to make it available in the future. Please reach out if you have experience in translations and are interested in contributing!

Opening a Pull Request

  1. Login to your GitHub account, or sign up for a new one at https://github.com/signup.

  2. Navigate to the file you want to modify, e.g. the Sentinel-2 JSON file.

  3. Click on the pen 🖊️ icon on the top right corner that says "Edit this file"

  4. This should bring you to a page like https://github.com/APECS-Earth-Observation/Polar-EO-Database/edit/main/data/Sentinel-2.json where you can make edits to the text using a web-based editor. Feel free to switch between the "Edit file" and "Preview changes" tabs as you modify the content to make sure things look ok.

  5. Once you're happy with your changes, scroll down to the bottom where it says Commit changes. This is where you will add a short summary of the changes you have made.

    The place to commit changes

    Specifically, in the first box, you will need to give a short title (e.g. "Fixed typo in Sentinel-2.json file") that describes the changes you've made. Optionally, you can write a few extra sentences in the second box to explain things in more detail.

  6. Select the "Create a new branch for this commit and start a pull request" option and provide a new branch name (e.g. "fix-sentinel-2-typo"). What this does is to ensure your changes are made in an independent manner or 'branch' away from the main trunk, and those changes will have the opportunity to be double checked and openly reviewed by other people.

  7. Click on the green 'Propose changes' button. This will bring you to a new page.

  8. Almost there! This "Open a pull request" page is where you can finalize things for the 'pull request' (a request to make changes) you will be opening soon. Again you will need to provide a title (e.g. 'Minor changes to the Sentinel-2 file') and a description.

    Pull request dialog page

    Be sure to provide any context on why you are making the changes, and how you are doing so. This will make it easier for other people to know what is happening when they review your changes.

  9. Ready? Click on the green 'Create pull request' button! This will make your changes available for everyone to see and review publicly. The maintainers will be notified about your great new addition and will get back to you on the next steps.

And that's it!

That's how you can easily become a member of the APECS community. ✨

This contributing guide was adapted from GitHub docs.