diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 0fbc98310..f75d80bcd 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -6,6 +6,10 @@ _As contributors and maintainers of this project, and in the interest of fosteri
 
 ## Getting Started
 
+Dev guides:
+
+- [Mac](docs/macDevGuide.md)
+
 We have full documentation on how to get started contributing here:
 
 - [Contributor License Agreement](https://git.k8s.io/community/CLA.md) Kubernetes projects require that you sign a Contributor License Agreement (CLA) before we can accept your pull requests
diff --git a/docs/macDevGuide.md b/docs/macDevGuide.md
new file mode 100644
index 000000000..d3eb5bdfb
--- /dev/null
+++ b/docs/macDevGuide.md
@@ -0,0 +1,52 @@
+# Developing on Mac OS
+
+## Setup your dev environment
+
+First install the tools to build and run tests
+
+### Install go 1.13
+
+[Instructions](https://golang.org/doc/install)
+
+Add `go` to your PATH
+
+### Install kubeval
+
+[Instructions](https://github.com/instrumenta/kubeval)
+
+```sh
+go get github.com/instrumenta/kubeval
+```
+
+Add `kubeval` to your PATH
+
+### Install gnu tools
+
+[Instructions](https://www.topbug.net/blog/2013/04/14/install-and-use-gnu-command-line-tools-in-mac-os-x/)
+
+```sh
+brew install coreutils wget sed
+```
+
+Add the new tools to your PATH
+
+## Clone Kustomize
+
+- Kustomize must be cloned under `$GOPATH/src/sigs.k8s.io/` or some of the tests will not work
+
+## Running the tests
+
+Run the `pre-commit.sh` script to verify your install
+
+```sh
+./travis/pre-commit.sh
+```
+
+This will run the go tests, as well as documentation tests.
+
+## Known Issues
+
+`pre-commit.sh` will modify all api/plugins by changing `linux` to `darwin`.
+See [#1711](https://github.com/kubernetes-sigs/kustomize/issues/1711) for details.
+
+Don't check these updates in.
\ No newline at end of file