Website Summary Files Commits Branches @commit @diff @stats
path: root / CONTRIBUTING.md
diff options
context:
space:
mode:
Commitad823cc4d72edbab10f0dadf99b30df91c3f7c50 (patch)
Author
 Dimitar Trendafilov <trendafilov.dn@gmail.com>
2020-08-16 08:38:04 +0300
Committer
 Dimitar Trendafilov <trendafilov.dn@gmail.com>
2020-08-16 08:38:04 +0300
Files6666a19acc2316d6ad5ad00291066d6d6fd42a5b /CONTRIBUTING.md
IPL-ad823cc4d72edbab10f0dadf99b30df91c3f7c50.tar
IPL-ad823cc4d72edbab10f0dadf99b30df91c3f7c50.tar.gz
IPL-ad823cc4d72edbab10f0dadf99b30df91c3f7c50.zip
Squashed 'website/themes/reveal-hugo/' content from commit ff9f389
git-subtree-dir: website/themes/reveal-hugo git-subtree-split: ff9f389743ae2fe5c5cc6101455db0616e8548e2
1 files changed, 27 insertions, 0 deletions
-rw-r--r--CONTRIBUTING.md27
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..851ab84
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,27 @@
+# Contributing to reveal-hugo
+
+Contributions of all shapes and sizes are welcoming, including code, documentation, and examples. If you've built something with reveal-hugo, feel free to add it to the README.
+
+To run the example site, clone this repository and run:
+
+```shell
+hugo server -s exampleSite
+```
+
+or simply...
+
+```shell
+npm start
+```
+
+You can also build the site without watching it for changes by running:
+
+```shell
+npm run build
+```
+
+GitHub issues and PRs are the preferred way to receive contributions. Please name your branch something recognizeable.
+
+Before opening a PR, make sure that the reveal-hugo exampleSite builds. The demo presentations in exampleSite use nearly all of the available reveal-hugo functionality, so they're a good indicator of something that might have been broken. Still, there are no fully automated tests, so please make sure to manually test areas that could be impacted by your change.
+
+If you need help contributing, don't hesitate to open an issue and ask. This is a welcoming and beginner-friendly project!