Skip to content

Commit

Permalink
contributing file added
Browse files Browse the repository at this point in the history
  • Loading branch information
ahnaf-tahmid-chowdhury committed Aug 30, 2023
1 parent 17612af commit 8e0771a
Showing 1 changed file with 68 additions and 0 deletions.
68 changes: 68 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
# Contributing to NuclearBoy

Thank you for your interest in contributing to **NuclearBoy**! We appreciate your efforts to improve the project and make it more useful for the nuclear physics community.

## Table of Contents

- [Code of Conduct](#code-of-conduct)
- [How Can I Contribute?](#how-can-i-contribute)
- [Reporting Bugs](#reporting-bugs)
- [Suggesting Enhancements](#suggesting-enhancements)
- [Submitting Pull Requests](#submitting-pull-requests)
- [Development Setup](#development-setup)
- [Coding Guidelines](#coding-guidelines)
- [License](#license)

## Code of Conduct

Please review and adhere to our [Code of Conduct](link-to-code-of-conduct) to ensure a respectful and inclusive environment for all contributors.

## How Can I Contribute?

### Reporting Bugs

If you encounter a bug while using **NuclearBoy**, we want to know! Please follow these steps:

1. Check the [existing issues](https://github.com/ahnaf-tahmid-chowdhury/NuclearBoy/issues) to see if the bug has already been reported.
2. If the bug is new, [open a new issue](https://github.com/ahnaf-tahmid-chowdhury/NuclearBoy/issues/new) with a detailed bug report using the provided [bug report template](.github/ISSUE_TEMPLATE/bug-report-template.md).
3. Provide a clear description of the bug, steps to reproduce it, and your environment details.

### Suggesting Enhancements

Have an idea for a new feature or improvement? We'd love to hear it! Here's what you can do:

1. Review the [existing issues](https://github.com/ahnaf-tahmid-chowdhury/NuclearBoy/issues) to avoid duplicate suggestions.
2. If your idea is new, [open a new issue](https://github.com/ahnaf-tahmid-chowdhury/NuclearBoy/issues/new) with a detailed description using the provided [feature request template](.github/ISSUE_TEMPLATE/feature-request-template.md).
3. Explain why you think this enhancement is valuable and how it could benefit the users.

### Submitting Pull Requests

Contributions from the community help us grow and improve **NuclearBoy**. Follow these steps to submit a pull request:

1. Fork the repository and create a new branch for your changes.
2. Make your modifications, adhering to the [coding guidelines](#coding-guidelines).
3. Test your changes thoroughly to ensure they work as intended.
4. [Open a new pull request](https://github.com/ahnaf-tahmid-chowdhury/NuclearBoy/compare) using the provided [pull request template](.github/pull-request-template.md).
5. Provide a clear description of the changes, the problem they solve, and the testing steps.

## Development Setup

If you're interested in contributing code, here's how to set up your development environment:

1. Fork the repository with branch `develop`.
1. Clone your fork of the repository: `git clone https://github.com/<USERNAME>/<REPOSITORY_NAME>.git`
2. Navigate to the project directory: `cd <REPOSITORY_NAME>`
3. Check out development branch: `git checkout develop`
4. Run the script: `./install-nuclear-boy.sh`
5. Install dependencies: `pip install -r packages.txt`
6. Run tests: `pytest -ra tests`

## Coding Guidelines

Please adhere to the established coding guidelines to maintain consistency across the project. This includes formatting, variable naming, and commenting practices. If you're not sure about something, feel free to ask for clarification in the relevant issue or pull request.

## License

By contributing to **NuclearBoy**, you agree that your contributions will be licensed under the project's [license](LICENSE). Your contributions will be acknowledged in the project's list of contributors.

Thank you for contributing to **NuclearBoy**!

0 comments on commit 8e0771a

Please sign in to comment.