about summary refs log tree commit diff
path: root/CONTRIBUTING.md
diff options
context:
space:
mode:
authorHeikki Kallasjoki <fis@zem.fi>2018-12-04 23:26:01 +0000
committerHeikki Kallasjoki <fis@zem.fi>2018-12-04 23:26:01 +0000
commitf5c20e9c9b46ac6efe3c3948302e4e20718a5968 (patch)
treedda96bf692be1c71607306f2f836b50f9a57982b /CONTRIBUTING.md
parent65439870f86997a6c50170a17cf0e399a39020a6 (diff)
downloadnano-exporter-f5c20e9c9b46ac6efe3c3948302e4e20718a5968.tar.gz
nano-exporter-f5c20e9c9b46ac6efe3c3948302e4e20718a5968.tar.xz
nano-exporter-f5c20e9c9b46ac6efe3c3948302e4e20718a5968.zip
Documentation improvements.
Include OpenWrt feed and installation instructions, as well as more details (and a README link) on how to contribute to the project.
Diffstat (limited to 'CONTRIBUTING.md')
-rw-r--r--CONTRIBUTING.md20
1 files changed, 20 insertions, 0 deletions
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 939e534..c1aba62 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -22,6 +22,26 @@ use GitHub pull requests for this purpose. Consult
 [GitHub Help](https://help.github.com/articles/about-pull-requests/) for more
 information on using pull requests.
 
+## Code style, structure & principles
+
+Please keep consistent with the existing code style, which is inspired
+by (the non-C++-specific parts of) the [Google C++ Style
+Guide](https://google.github.io/styleguide/cppguide.html), with a few
+exceptions: no mixed-case names, and a 100-character line length
+limit.
+
+The goal of the project is to be lightweight and have no large
+external dependencies. If you wish to add a collector that inherently
+depends on a library, it should be optional to the build, and probably
+not included by default.
+
+All exported metrics should be related to the node (host, machine...)
+the exporter is running on, not to any specific service running on
+it. Services should optimally export their own metrics natively, or
+via an exporter specific to the service. Alternatively, you might be
+interested in [mtail](https://github.com/google/mtail), which extracts
+monitoring data from log files.
+
 ## Community Guidelines
 
 This project follows [Google's Open Source Community