- Initial documentation on contributing to gh-ost.

- It is a bit sparse currently, but will give beginners an idea how on to setup the environment and run tests.
- A good starting point for further PR's.
This commit is contained in:
Jess Breckenridge 2017-05-03 14:25:31 -06:00
parent d757539d3c
commit e017ec18e4

23
doc/codingghost.md Normal file
View File

@ -0,0 +1,23 @@
# Getting started with gh-ost development.
## Overview
Getting started with gh-ost development is simple!
- First clone the repository.
- From inside of the repository run `script/cibuild`
- This will bootstrap the environment if needed, format the code, build the code, and then run the unit test.
## CI build workflow
`script/cibuild` performs the following actions:
- It runs `script/bootstrap`
- `script/bootstrap` run `script/ensure-go-installed`
- `script/ensure-go-installed` installs go locally if (go is not installed) || (go is not version 1.7). It also will not install go if it is already installed locally.
- `script/build` builds the binary and places in in `bin/`
## Notes:
Currently, `script/ensure-go-installed` will install `go` for Mac OS X and Linux. We welcome PR's to add other platforms.