summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorDario Maiocchi <dmaiocchi@suse.com>2017-11-09 18:55:05 +0100
committerDario Maiocchi <dmaiocchi@suse.com>2017-11-10 14:16:25 +0100
commit904e9b2b619cafbc2cb2cc162e65c4ececfe2d01 (patch)
treea96851e44877ed410ad3ce71d341b069a6eb128f /doc
parenta6f137024b0e61e2d6c67c7cb0195493a38d3815 (diff)
downloadterraform-provider-libvirt-904e9b2b619cafbc2cb2cc162e65c4ececfe2d01.tar
terraform-provider-libvirt-904e9b2b619cafbc2cb2cc162e65c4ececfe2d01.tar.gz
Improve layout Readme
Create minimal howtocontribute
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 ./...
+```