Skip to content
This repository was archived by the owner on Jan 14, 2024. It is now read-only.

Commit b03706c

Browse files
authored
chore: adding contributing guide content from chatgpt (#4)
* chore: adding contributing guide content from chatgpt * chore: contributing guide docs updated
1 parent 2f2fbdb commit b03706c

1 file changed

Lines changed: 58 additions & 0 deletions

File tree

CONTRIBUTING.md

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1 +1,59 @@
11
# Contributing Guide
2+
3+
**Table of Contents**:
4+
5+
- [Client](#contributing-to-the-client-side)
6+
- [Backend](#contributing-to-the-backend-side)
7+
- [Model](#contributing-to-the-model-side)
8+
- [Code Style Guidelines](#code-style-guidelines)
9+
- [Bug Reports & Feature Requests](#bug-reports-and-feature-requests)
10+
- [Conclusion](#conclusion)
11+
12+
Thank you for your interest in contributing to the Hardware Web UI project! We welcome any contributions, whether they be in the form of bug fixes, feature requests, or new code. This guide will provide you with all the information you need to get started contributing to this project.
13+
14+
## Contributing to the Client Side
15+
16+
The client side of the Hardware Web UI project is built using React and TypeScript. If you would like to contribute to the client side of the project, please follow these steps:
17+
18+
1. Fork the repository and clone your forked repository to your local machine.
19+
2. Install the required dependencies for the client by running `yarn` or `npm` install inside the client directory.
20+
3. Make the desired changes to the code.
21+
4. Run the client using `yarn start` or `npm start` to verify that your changes are working as expected.
22+
5. Commit your changes and push them to your forked repository.
23+
6. Open a pull request to the original repository and describe the changes you have made.
24+
25+
## Contributing to the Backend Side
26+
27+
The backend side of the Hardware Web UI project is built using Python and FastAPI. If you would like to contribute to the backend side of the project, please follow these steps:
28+
29+
1. Fork the repository and clone your forked repository to your local machine.
30+
2. Install the required dependencies for the backend by running `pip install -r requirements.txt`.
31+
3. Make the desired changes to the code.
32+
4. Run the server using `py main.py` to verify that your changes are working as expected.
33+
5. Commit your changes and push them to your forked repository.
34+
6. Open a pull request to the original repository and describe the changes you have made.
35+
36+
## Contributing to the Model Side
37+
38+
The model used in the Hardware Web UI project is a neural network that detects breast cancer. If you would like to contribute to the model side of the project, please follow these steps:
39+
40+
1. Fork the repository and clone your forked repository to your local machine.
41+
2. Download the required dataset and trained file from the links provided in the project description.
42+
3. Use the dataset to train a new model or make changes to the existing model.
43+
4. Save the new trained model as a `.h5` file in the project root directory.
44+
5. Make the desired changes to the code.
45+
6. Run the server using `py main.py` to verify that your changes are working as expected.
46+
7. Commit your changes and push them to your forked repository.
47+
8. Open a pull request to the original repository and describe the changes you have made.
48+
49+
## Code Style Guidelines
50+
51+
We follow the PEP 8 style guide for Python code and the Airbnb style guide for JavaScript and TypeScript code. Please make sure that your code adheres to these style guidelines before opening a pull request.
52+
53+
## Bug Reports and Feature Requests
54+
55+
If you find a bug in the project or have a feature request, please open an issue on the project's GitHub page. When reporting a bug, please include as much detail as possible about the issue and steps to reproduce it. When requesting a new feature, please describe the feature in as much detail as possible.
56+
57+
## Conclusion
58+
59+
Thank you for your interest in contributing to the Hardware Web UI project. We appreciate any contributions and look forward to working with you! For any issue or question, feel free to ping me at kunalkeshan12@gmail.com.

0 commit comments

Comments
 (0)