Skip to content

Commit 20d9534

Browse files
authored
docs: Updating licence & contribution guidelines (#91)
* Updated licence * Updated docs, added more details regarding contributions
1 parent 6d75804 commit 20d9534

File tree

5 files changed

+53
-18
lines changed

5 files changed

+53
-18
lines changed

CONTRIBUTING.md

Lines changed: 40 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -6,18 +6,50 @@ We love your input! We want to make contributing to this project as easy and tra
66
- Discussing the current state of the code
77
- Submitting a fix
88
- Proposing new features
9+
- Adding support for new hardware
910
- Becoming a maintainer
1011

11-
## Making changes to the code
12+
## Naming conventions
1213

13-
Pull requests are the best way to propose changes to the codebase. We actively welcome your pull requests:
14+
Be sure to follow the naming conventions used throughout the project (e.g., variable names, function names, file names,
15+
etc.).
1416

15-
1. Fork the repo and create your branch from `main`.
16-
2. If you've added code that should be tested, add tests.
17-
3. If you've changed APIs, update the documentation.
18-
4. Ensure the test suite passes.
19-
5. Make sure your code lints.
20-
6. Issue that pull request!
17+
Also make sure the commit messages are clear and concise, following
18+
the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/).
19+
20+
## Reporting issues
21+
22+
If you find a bug in the project, please open an issue on the project's GitHub repository. When opening an issue, please
23+
provide as much information as possible, including the version of the project you are using, the operating system you
24+
are using, and any relevant error messages and logs.
25+
26+
### New features
27+
28+
If you would like to contribute code to the project, please follow these steps:
29+
30+
1. Fork the project on GitHub.
31+
2. Create a new branch for your changes.
32+
3. Make your changes on the new branch.
33+
4. Write tests for your changes.
34+
5. Run the tests to make sure they pass.
35+
6. Submit a pull request to the project's GitHub repository.
36+
7. Create necessary documentation for your changes, for example, how to use the new feature, how to configure it and
37+
preferably design docs.
38+
39+
That's it! We will review your pull request and provide feedback as soon as possible.
40+
41+
### Hardware support
42+
43+
If you would like to add support for new hardware to the project, please follow these steps:
44+
45+
1. Fork the project on GitHub.
46+
2. Create a new branch for your changes.
47+
3. Make your changes on the new branch.
48+
4. Write tests for your changes.
49+
5. Run the tests to make sure they pass and perform necessary hardware tests.
50+
6. Submit a pull request to the project's GitHub repository.
51+
7. Create documentation for the new hardware, describing features, installation and usage.
52+
8. (Optional) Write some guidelines on how to use, handle and maintain the new hardware.
2153

2254
## Any contributions you make will be under the MIT Software License
2355

LICENSE.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
MIT License
22

3-
Copyright (c) 2021-2023 Blaž Dular
3+
Copyright (c) 2021-2025 The ChargePi project
44

55
Permission is hereby granted, free of charge, to any person obtaining a copy
66
of this software and associated documentation files (the "Software"), to deal

ReadMe.md

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -28,8 +28,12 @@ connecting to the backend.
2828
- **Easy replication** - ChargePi is easy to replicate. It can be deployed on a Raspberry Pi or any other Linux-based
2929
device. Configurations can be easily exported from an existing device to other devices.
3030
- **Hardware-agnostic** - ChargePi supports a variety of hardware components. You can mix and match the hardware
31-
components to create a charging station that suits your needs.
32-
- **API** - ChargePi comes with an API that allows you to integrate it with other systems.
31+
components to create a charging station that suits your needs. You can also write custom drivers for currently
32+
unsupported hardware. We are always looking for contributors to add support for new hardware components.
33+
- **Modular** - ChargePi is modular, allowing you to add or remove components as needed, based on your use case. You can
34+
easily add new hardware components or functionalities to your charging station.
35+
- **API** - ChargePi comes with an API that allows you to integrate it with other systems or implement custom
36+
functionality.
3337

3438
## Roadmap
3539

@@ -114,8 +118,10 @@ Client comes with default settings which require minimal configuration.
114118

115119
## Contributing
116120

117-
Contributions are welcome! Please check out the [contributing guide](/docs/contributing/contributing.md) for more
118-
information.
121+
Contributions are welcome! Whether you want to add support for new hardware components, improve the documentation,
122+
found a bug or have an idea for a new feature, we appreciate your help!
123+
124+
Please check out the [contributing guide](/docs/contribution/contributing.md) for more information on how to contribute.
119125

120126
## License
121127

docs/configuration/configuration.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -97,7 +97,7 @@ chargePoint:
9797
maxPower: 11
9898
maxChargingTime: 5
9999
ocpp:
100-
vendor: UL FE
100+
vendor: ChargePi
101101
model: ChargePi
102102

103103
logging:

docs/contribution/client/api.md

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,5 @@ on `localhost:4269`.
1212
Compiling the protobuf:
1313

1414
```bash
15-
protoc --go_out=./internal/api --go_opt=paths=source_relative \
16-
--proto_path=pkg/proto \
17-
--go-grpc_out=./internal/api --go-grpc_opt=paths=source_relative \
18-
pkg/proto/*.proto
15+
buf generate
1916
```

0 commit comments

Comments
 (0)