gh-ost/doc/coding-ghost.md

# Getting started with gh-ost development.

## Overview

Getting started with gh-ost development is simple!

- First obtain the repository with `git clone` or `go get`.
- 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 will bootstrap the environment to build `gh-ost` correctly, build, perform syntax checks and run unit tests.

If additional steps are needed, please add them into this workflow so that the workflow remains simple.

## Notes:

Currently, `script/ensure-go-installed` will install `go` for Mac OS X and Linux. We welcome PR's to add other platforms.
- 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. 2017-05-03 20:25:31 +00:00			`# Getting started with gh-ost development.`

			`## Overview`

			`Getting started with gh-ost development is simple!`

- Updating PR template to reflect current build workflow 2017-05-04 18:51:00 +00:00			- First obtain the repository with `git clone` or `go get`.
- 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. 2017-05-03 20:25:31 +00:00			- 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`

- Updating PR template to reflect current build workflow 2017-05-04 18:51:00 +00:00			`script/cibuild` performs the following actions will bootstrap the environment to build `gh-ost` correctly, build, perform syntax checks and run unit tests.
- 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. 2017-05-03 20:25:31 +00:00
- Updating PR template to reflect current build workflow 2017-05-04 18:51:00 +00:00			`If additional steps are needed, please add them into this workflow so that the workflow remains simple.`
- 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. 2017-05-03 20:25:31 +00:00
			`## Notes:`

			Currently, `script/ensure-go-installed` will install `go` for Mac OS X and Linux. We welcome PR's to add other platforms.