Skip to content

Commit

Permalink
added draft for contribution guidelines
Browse files Browse the repository at this point in the history
  • Loading branch information
simeon-ned committed Sep 17, 2024
1 parent 9f3f4c7 commit f256e4f
Show file tree
Hide file tree
Showing 2 changed files with 61 additions and 6 deletions.
57 changes: 57 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
# Contributing to JaxADi

We're thrilled that you're interested in contributing to JaxADi! This document outlines the process for contributing to this project.

## How to Contribute

There are many ways to contribute to JaxADi:

1. Reporting bugs
2. Suggesting enhancements
3. Writing documentation
4. Submitting code changes

### Reporting Bugs

1. Check the [issue tracker](https://github.com/based-robotics/jaxadi/issues) to see if the bug has already been reported.
2. If not, create a new issue. Provide a clear title and description, as much relevant information as possible, and a code sample or executable test case demonstrating the bug.

### Suggesting Enhancements

1. Check the [issue tracker](https://github.com/based-robotics/jaxadi/issues) to see if the enhancement has already been suggested.
2. If not, create a new issue. Clearly describe the enhancement, why it would be useful, and any potential drawbacks.

### Writing Documentation

Good documentation is crucial. If you notice any part of our documentation that could be improved or expanded, please let us know or submit a pull request with your suggested changes.

### Submitting Code Changes

1. Fork the repository.
2. Create a new branch for your changes.
3. Make your changes in your branch.
4. Add or update tests as necessary.
5. Ensure the test suite passes.
6. Update the documentation as needed.
7. Push your branch and submit a pull request.

## Pull Request Process

1. Ensure your code follows the project's style guidelines.
2. Update the README.md or relevant documentation with details of changes, if applicable.
3. Add tests for your changes and ensure all tests pass.
4. Your pull request will be reviewed by the maintainers. They may suggest changes or improvements.
5. Once approved, your pull request will be merged.

<!-- TODO:
## Style Guidelines
We use Ruff to enforce our code style and linting rules....
```bash
pip3 install pre-commit
```
```bash
pre-commit install
``` -->

10 changes: 4 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -86,9 +86,9 @@ JAXADI comes with several examples to help you get started:
(Consider adding a section about performance comparisons between CasADi and JAXADI-translated functions) -->

<!-- ## Contributing
## Contributing

We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for more details. -->
We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for more details.

## Citation

Expand All @@ -97,11 +97,9 @@ If you use JaxADi in your research, please cite it as follows:
```bibtex
@misc{jaxadi2024,
title = {JaxADi: Bridging CasADi and JAX for Efficient Numerical Computing},
author = {Kozlov, Lev and Alentev, Igor and Nedelchev, Simeon},
author = {Alentev, Igor and Kozlov, Lev and Nedelchev, Simeon},
year = {2024},
publisher = {GitHub},
journal = {GitHub repository},
howpublished = {\url{https://github.com/based-robotics/jaxadi}},
url = {https://github.com/based-robotics/jaxadi},
note = {Accessed: [Insert Access Date]}
}
```
Expand Down

0 comments on commit f256e4f

Please sign in to comment.