[PR]: Simplify the contributing guide

[tomvothecoder]

Description

• Closes [Doc]: Simplify the contributing guide #590
• Now based on and inspired by Xarray contributing guide

Todo list

• Add Overview section
• Add Where to start? section
  • Documentation updates
  • Bug reports
  • Enhancement requests
  • All other inquiries
• Add Version control, Git, and GitHub section
  • Getting started with Git
• Add Creating a development environment section
  • Install pre-commit hooks
• Add Contributing to codebase section
  • Pull Request (PR)
  • Code Formatting
  • Testing with Continuous Integration
  • Writing Tests
• Add Developer Tips section
  • Helpful commands
  • xCDAT and Visual Studio Code

Checklist

• My code follows the style guidelines of this project
• I have performed a self-review of my own code
• My changes generate no new warnings
• Any dependent changes have been merged and published in downstream modules

If applicable:

• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass with my changes (locally and CI/CD build)
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• I have noted that this is a breaking change for a major release (fix or feature that would cause existing functionality to not work as expected)

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 100.00%. Comparing base (472c04b) to head (6b5d6c4).

Additional details and impacted files

@@            Coverage Diff            @@
##              main      #593   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           15        15           
  Lines         1521      1521           
=========================================
  Hits          1521      1521           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[tomvothecoder]

Hey @xCDAT/core-developers, here is my initial PR draft to simplify the contributing guide. It is based on Xarray's contributing guide, but geared towards xCDAT and made even simpler.

If any of you are available for a quick review, that would be great. You can review the page directly in this Read The Docs preview: https://xcdat.readthedocs.io/en/update-contributing-guide/contributing.html. Thanks!

Here is the old version if you wanted to compare against it: https://xcdat.readthedocs.io/en/v0.6.0/contributing.html. I removed overly technical sections about version control/Git and pre-commit, re-organized and simplified sections such as setting up a dev env, and made it more friendly sounding (less stringent guidelines and standards).

[tomvothecoder]

Hi @chengzhuzhang, just tagging you for review on this PR. It's not urgent, so whenever you have time for it that would be great.

[pochedls]

@tomvothecoder – I did make some changes locally (from my forked repo). I basically just deleted mamba stuff (conda now uses the mamba solver by default).

I had some git setup steps (I tried to start from scratch), e.g.,:

git config --global user.name “…”
git config --global user.email “…”

But I think that can be beyond the scope of our developer guide. We may need to help some of our users with git stuff.

[tomvothecoder]

@tomvothecoder – I did make some changes locally (from my forked repo). I basically just deleted mamba stuff (conda now uses the mamba solver by default).

@pochedls Thanks for the reminder about this update to Conda's default solver. In this commit I added your suggestions and updated the Installation page to change mamba references back to conda.

I had some git setup steps (I tried to start from scratch), e.g.,:

git config --global user.name “…”
git config --global user.email “…”

But I think that can be beyond the scope of our developer guide. We may need to help some of our users with git stuff.

I added a section on setting up the repo by either cloning or forking (this commit).

My thinking was that adding git content would make the contributing guide lengthy. From my experience, the basic commands are easy to look up (configs, cloning, fetching, pulling, pushing, and rebasing). As an alternative, we can help individual contributors directly if they have issues with Git.