Skip to content

Commit

Permalink
Add CONTRIBUTING.md
Browse files Browse the repository at this point in the history
  • Loading branch information
cpvannier committed Nov 15, 2023
1 parent bbe9c72 commit 6457046
Show file tree
Hide file tree
Showing 3 changed files with 43 additions and 5 deletions.
1 change: 1 addition & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@ All notable changes to Pixano will be documented in this file.
### Added

- Add GitHub actions to format Python, UI, and Markdown code
- Add CONTRIBUTING.md for installation information and contribution guidelines

### Changed

Expand Down
41 changes: 41 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
# Contributing to Pixano Inference

Thank you for your interest in Pixano Inference! Here you will find information on running Pixano Inference locally and guidelines on how to publish your contributions.

## Getting started

### Issue and suggestions

If you find a bug or you think of some missing features that could be useful while using Pixano Inference, please [open an issue](https://github.com/pixano/pixano-inference/issues)!

### Modifications

To contribute more actively to the project, you are welcome to develop the fix or the feature you have in mind, and [create a pull request](https://github.com/pixano/pixano-inference/pulls)!

And if you want to change the module to your liking, feel free to [fork this repository](https://github.com/pixano/pixano-inference/fork)!

## Running Pixano Inference locally

If you are looking to contribute to Pixano Inference and develop new features, you will need to clone the Pixano Inference repository and run it locally.

### Requirements

You will need `python == 3.10`. Then, inside the root `pixano_inference/` directory, run this command to install all the Python dependencies:

```bash
pip install .
```

## Formatting the code

We use these extensions for formatting the Pixano Inference source code:

- Black: Python, Jupyter
- https://marketplace.visualstudio.com/items?itemName=ms-python.black-formatter
- Prettier: Typescript, Javascript, Svelte, HTML, CSS, JSON, YAML, Markdown
- https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode
- https://marketplace.visualstudio.com/items?itemName=svelte.svelte-vscode

## Updating the changelog

When you want to create a pull request with the changes you have made, please update the CHANGELOG.md accordingly.
6 changes: 1 addition & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,11 +29,7 @@ Please refer to [these Pixano notebooks](https://github.com/pixano/pixano/tree/m

# Contributing

If you find a bug or you think of some missing features that could be useful while using Pixano Inference, please [open an issue](https://github.com/pixano/pixano-inference/issues)!

To contribute more actively to the project, you are welcome to develop the fix or the feature you have in mind, and [create a pull request](https://github.com/pixano/pixano-inference/pulls)!

And if you want to change the module to your liking, feel free to [fork this repository](https://github.com/pixano/pixano-inference/fork)!
Please refer to the [CONTRIBUTING.md](CONTRIBUTING.md) for information on running Pixano locally and guidelines on how to publish your contributions.

# License

Expand Down

0 comments on commit 6457046

Please sign in to comment.