summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorThomas Hipp <thomashipp@gmail.com>2017-11-10 15:25:20 +0100
committerGitHub <noreply@github.com>2017-11-10 15:25:20 +0100
commit6896ed4e03b29fe47b60e0e818f48c4ae5c29157 (patch)
tree36c889dc7991d3f478842103af2c957326713418 /doc
parent448470a3de2d474594cf636906462e850f45901d (diff)
parent904e9b2b619cafbc2cb2cc162e65c4ececfe2d01 (diff)
downloadterraform-provider-libvirt-6896ed4e03b29fe47b60e0e818f48c4ae5c29157.tar
terraform-provider-libvirt-6896ed4e03b29fe47b60e0e818f48c4ae5c29157.tar.gz
Merge pull request #223 from MalloZup/layout
Readme layout improvements
Diffstat (limited to 'doc')
-rw-r--r--doc/CONTRIBUTING.md27
1 files changed, 27 insertions, 0 deletions
diff --git a/doc/CONTRIBUTING.md b/doc/CONTRIBUTING.md
new file mode 100644
index 00000000..ddde4637
--- /dev/null
+++ b/doc/CONTRIBUTING.md
@@ -0,0 +1,27 @@
+# Where to start?
+
+Look at open issues, especially with label:
+
+- [junior job](https://github.com/dmacvicar/terraform-provider-libvirt/issues?q=is%3Aissue+is%3Aopen+label%3A%22junior+job%22),
+- [help wanted](https://github.com/dmacvicar/terraform-provider-libvirt/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22)
+
+# Contribute
+
+1. [Build the plugin from source](https://github.com/dmacvicar/terraform-provider-libvirt#building-from-source)
+2. If you have issues, check out the [troubleshooting](https://github.com/dmacvicar/terraform-provider-libvirt/blob/master/doc/TROUBLESHOOTING.md)
+3. Do your code (reference issue on your pr if you fix them) [Closing issues keywords](https://help.github.com/articles/closing-issues-using-keywords/)
+4. Run the acceptance tests.
+
+## Writing acceptance tests.
+
+https://github.com/hashicorp/terraform/blob/master/.github/CONTRIBUTING.md#running-an-acceptance-test
+
+## Running acceptance tests
+
+You need to define the ```LIBVIRT_DEFAULT_URI``` and ```TF_ACC``` variables.
+
+```console
+export LIBVIRT_DEFAULT_URI=qemu:///system
+export TF_ACC=1
+go test ./...
+```