If you are reading this, you may be to contribute. Just for that, a big thank you ! 👏
Feel free to propose pull requests, or open new discussions or issues at will. Scaphandre is a collaborative project and all opinions and propositions shall be heard and studied. The contributions will be received with kindness, gratitude and with an open mind. Remember that we are all dwarfs standing on the shoulders of giants. We all have to learn from others and to give back, with due mutual respect.
This project adheres to the Rust Code of Conduct, which can be found here.
Contributions may take multiple forms:
- 💻 code, of course, but not only (there is a lot more !)
- 📖 documentation : here is a guide to edit and build the documentation
- 🎤 Any help on communication: writing blog posts, speaking about scaphandre in conferences, speaking and writing about the responsibility of tech to be sustainable as well !
- 🧬 structuring the project and the community is also a very important topic. Feel free to propose help, or start discussions about that.
This project intends to unite a lot of people to have a lot of positive impact. Any action going helping us to get there will be very much appreciated ! 🎉
Scaphandre is a not only a tool, but a framework. Modules dedicated to collect energy consumption data from the host are called Sensors. Modules that are dedicated to send this data to a given channel or remote system are called Exporters. New Sensors and Exporters are going to be created and all contributions are welcome. For more on the internal structure please jump here.
Documentation source files are in
docs_src, edit the content there and propose pull-requests on the scaphandre repository as if it was a code pull-request.
cargo install mdbook
Then fork the scaphandre-documentation repository and clone the resulting repository locally.
Place the resulting documentation folder next to scaphandre's folder. Then run the build:
cd scaphandre && mdbook build
You should then have the result in
scaphandre-documentation/docs. Commit, push and propose a PR to publish the changes.
You can also serve the current content locally to see your changes before commit: