aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md20
1 files changed, 20 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c468f07
--- /dev/null
+++ b/README.md
@@ -0,0 +1,20 @@
+# Best Practices
+
+Make your code 💯 - A collection of best practices for software
+
+This repository contains [guides on best-practices](guides/) for many
+languages and technologies used at Driver. Check out the
+[website](https://drivergroup.github.io/best-practices).
+
+## Building
+
+The website is built with [pandoc](https://pandoc.org/) and published
+via [GitHub Pages](https://pages.github.com/).
+
+Changes can be applied by running `make` and viewing the website
+locally in the directory ".ghpages".
+
+The website can be published by running `make publish`. This will
+build the website locally and push any resulting HTML to the github
+branch "gh-pages". Be sure that your changes have been accepted and
+merged before doing this!