Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add contributors guide #112

Open
wants to merge 20 commits into
base: dev
Choose a base branch
from
Open

Add contributors guide #112

wants to merge 20 commits into from

Conversation

schmoelder
Copy link
Contributor

@schmoelder schmoelder commented Mar 14, 2024

This PR adds a contributor's guide to CADET-Process.

To do

  • Create environment
  • Install dependencies (e.g. pip install -e .)
  • Style guide (black / ruff / pre-commit)
  • Branch policies (e.g. fix/..., feature/...)
  • Issues vs PRs
  • How to run tests (unittest vs pytest)
  • How to build documentation
  • Publish package
  • Sign CLA
  • ...?

References

Here are some references to get inspiration:

@schmoelder schmoelder changed the base branch from master to dev March 14, 2024 11:38
@schmoelder schmoelder force-pushed the dev branch 4 times, most recently from f778466 to 0534130 Compare March 16, 2024 12:45
@schmoelder schmoelder force-pushed the dev branch 8 times, most recently from 9478b91 to 841f188 Compare March 23, 2024 16:08
@schmoelder schmoelder force-pushed the dev branch 2 times, most recently from d10f69b to cd4c8ee Compare March 26, 2024 15:33
ronald-jaepel and others added 10 commits June 18, 2024 21:13
Previously, there were two interfaces in the `OptimizationProblem` for calling evaluation functions (e.g. objectives): one for evaluating individuals, and one for populations.
To simplify the code base, these two methods were now unified.
To ensure backward compatibility, a 1D-Array is returned if a single individual is passed to the function.
@schmoelder schmoelder force-pushed the contributors_guide branch from 760214f to 94743bd Compare June 19, 2024 08:49
Thanks for your interest in contributing to **CADET-Process**!
To streamline the development, please carefully read the following guide.

# How to contribute
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Watch header level


For further guidance about getting started, please refer to the related links:

* [Pull Request Guidelines](PULL_REQUEST_TEMPLATE.md)
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should also add templates for CADET-Process (see cadet/CADET-Core#207)


## Coding conventions

> Code should be optimized for readability. Attach some custom style guide or reference some. i.e.:
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Update for Python.


In order to sanitize coding standards, please follow [this style guide](https://github.com/airbnb/javascript).

## Code of Conduct
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we really need this?


> This section should explicitly state that we will not discriminate against people on any grounds other than their code contributions, and make clear that behaviour that would be harmful to other people that may wish to contribute is not acceptable. This gives clear authority to remove people who are causing problems, and also sets a clear tone of inclusion.

> **ProTip:** You can find more about [Contributor Covenant](http://contributor-covenant.org) or as a seperate `code_of_conduct` file. [Good sample](http://contributor-covenant.org/version/1/4/).
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add information about CLA!


## I would like to join this list. How can I help the project?

For more information, please refer to our [CONTRIBUTING](CONTRIBUTING) guide.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

missing .md

@schmoelder schmoelder self-assigned this Jun 19, 2024
@schmoelder schmoelder added the documentation Improvements or additions to documentation label Jun 19, 2024
@schmoelder schmoelder force-pushed the dev branch 11 times, most recently from 35e0c67 to d97cf31 Compare December 4, 2024 16:47
@schmoelder schmoelder added this to the v0.11.0 milestone Dec 5, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants