From 876fccbbde53e27b3fb820808d2c336ca71aa7e1 Mon Sep 17 00:00:00 2001 From: Jakob Odersky Date: Fri, 14 Sep 2018 17:59:21 -0700 Subject: Make this repo a standalone website These changes add the ability to generate a full website from individual style guides. The website can be viewed [here](drivergroup.github.io/best-practices). Also included, are the following additions: - Improve recommendations for Scala. - Add more recommendations for Git. - Add recommendations for Shell Script. --- README.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 README.md (limited to 'README.md') 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! -- cgit v1.2.3