mirror of
https://github.com/kidoman/embd
synced 2024-12-22 04:40:04 +01:00
doc: how to contribute
This commit is contained in:
parent
03dc549a01
commit
4ebfe9ccc7
31
CONTRIBUTING.md
Normal file
31
CONTRIBUTING.md
Normal file
@ -0,0 +1,31 @@
|
|||||||
|
# Contributing to EMBD
|
||||||
|
|
||||||
|
This actually is really simple. A few simple guidelines and we can break for dinner:
|
||||||
|
|
||||||
|
* EMBD is designed with a lot of affection, with utmost importance given to the dev experience (read: the API feel and style.) So always think from that angle when creating the pull request
|
||||||
|
* [Documentation](https://godoc.org/github.com/kidoman/embd) helps drive adoption. No exceptions
|
||||||
|
|
||||||
|
When it comes to the code:
|
||||||
|
|
||||||
|
* Always [gofmt + goimports](https://michaelwhatcott.com/gosublime-goimports/) the code. We absolutely adore them. Sublime Text 3 with GoSublime + GoImports is a very potent combination in our opinion
|
||||||
|
* Often you will hear us mention idiomatic Go ([read](http://golang.org/doc/effective_go.html).) Writing Go "The Go Way™" helps keep the code readable and understandable by all Gophers.
|
||||||
|
* No blank lines where they don't belong
|
||||||
|
|
||||||
|
'commit'tee called:
|
||||||
|
|
||||||
|
* Commit messages should be all lower case, unless when absolutely required (proper nouns, acronyms, etc.)
|
||||||
|
* When possible, prefix the message with the general area the commit is regarding. Good examples would be ```doc```, ```gpio```, ```bbb```. You get the drift
|
||||||
|
* If the commit message is long, then follow this convention:
|
||||||
|
|
||||||
|
```
|
||||||
|
gpio: adding interrupts
|
||||||
|
|
||||||
|
this is inspired by Dave Cheney's gpio library and his work on EPOLL
|
||||||
|
```
|
||||||
|
|
||||||
|
* Individual lines must be wrapped at the 70-char limit. Yeah, old school
|
||||||
|
* No trailing '.'
|
||||||
|
|
||||||
|
And:
|
||||||
|
|
||||||
|
* Real tabs for indentation
|
@ -156,6 +156,12 @@ platforms.
|
|||||||
|
|
||||||
* **ServoBlaster** RPi PWM/PCM based PWM controller [Documentation](http://godoc.org/github.com/kidoman/embd/controller/servoblaster), [Product Page](https://github.com/richardghirst/PiBits/tree/master/ServoBlaster)
|
* **ServoBlaster** RPi PWM/PCM based PWM controller [Documentation](http://godoc.org/github.com/kidoman/embd/controller/servoblaster), [Product Page](https://github.com/richardghirst/PiBits/tree/master/ServoBlaster)
|
||||||
|
|
||||||
|
## Contributing
|
||||||
|
|
||||||
|
We look forward to your pull requests, but contributions which abide by the [guidelines](https://github.com/kidoman/embd/blob/master/CONTRIBUTING.md) will get a free beer!
|
||||||
|
|
||||||
|
File an [issue](https://github.com/kidoman/embd/issues), open a [pull request](https://github.com/kidoman/embd/pulls). We are waiting.
|
||||||
|
|
||||||
## About
|
## About
|
||||||
|
|
||||||
EMBD is affectionately designed/developed by Karan Misra ([kidoman](https://github.com/kidoman)), Kunal Powar ([kunalpowar](https://github.com/kunalpowar)) and [FRIENDS](https://github.com/kidoman/embd/blob/master/AUTHORS).
|
EMBD is affectionately designed/developed by Karan Misra ([kidoman](https://github.com/kidoman)), Kunal Powar ([kunalpowar](https://github.com/kunalpowar)) and [FRIENDS](https://github.com/kidoman/embd/blob/master/AUTHORS).
|
||||||
|
Loading…
x
Reference in New Issue
Block a user