mirror of
https://github.com/kata-containers/kata-containers.git
synced 2025-10-21 20:08:54 +00:00
a8aaf534b6
This commit adds three documents: - CONTRIBUTING.md ( a files describing how to contribute to the project )` - COPYING ( the Apache 2.0 license ) - README.md ( a brief description of the project) Signed-off-by: Mark Ryan <mark.d.ryan@intel.com>
63 lines
1.9 KiB
Markdown
63 lines
1.9 KiB
Markdown
# Contributing to Virtual Machine Manager for Go
|
|
|
|
Virtual Machine Manager for Go is an open source project licensed under the [Apache v2 License] (https://opensource.org/licenses/Apache-2.0)
|
|
|
|
## Coding Style
|
|
|
|
Virtual Machine Manager for Go follows the standard formatting recommendations and language idioms set out
|
|
in [Effective Go](https://golang.org/doc/effective_go.html) and in the
|
|
[Go Code Review Comments wiki](https://github.com/golang/go/wiki/CodeReviewComments).
|
|
|
|
## Certificate of Origin
|
|
|
|
In order to get a clear contribution chain of trust we use the [signed-off-by language] (https://01.org/community/signed-process)
|
|
used by the Linux kernel project.
|
|
|
|
## Patch format
|
|
|
|
Beside the signed-off-by footer, we expect each patch to comply with the following format:
|
|
|
|
```
|
|
Change summary
|
|
|
|
More detailed explanation of your changes: Why and how.
|
|
Wrap it to 72 characters.
|
|
See [here] (http://chris.beams.io/posts/git-commit/)
|
|
for some more good advices.
|
|
|
|
Fixes #NUMBER (or URL to the issue)
|
|
|
|
Signed-off-by: <contributor@foo.com>
|
|
```
|
|
|
|
For example:
|
|
|
|
```
|
|
Fix poorly named identifiers
|
|
|
|
One identifier, fnname, in func.go was poorly named. It has been renamed
|
|
to fnName. Another identifier retval was not needed and has been removed
|
|
entirely.
|
|
|
|
Fixes #1
|
|
|
|
Signed-off-by: Mark Ryan <mark.d.ryan@intel.com>
|
|
```
|
|
|
|
## Pull requests
|
|
|
|
We accept github pull requests.
|
|
|
|
## Quality Controls
|
|
|
|
We request you give quality assurance some consideration by:
|
|
|
|
* Adding go unit tests for changes where it makes sense.
|
|
* Enabling [Travis CI](https://travis-ci.org/intel/govmm) on your github fork of Virtual Machine Manager for Go to get continuous integration feedback on your dev/test branches.
|
|
|
|
## Issue tracking
|
|
|
|
If you have a problem, please let us know. If it's a bug not already documented, by all means please [open an
|
|
issue in github](https://github.com/intel/govmm/issues/new) so we all get visibility
|
|
the problem and work toward resolution.
|