docs: add a simple local development guide

[joekr]

What this PR does / why we need it:
Simply adds a markdown doc for local development. I keep forgetting what the auth config and registry ENVs when doing development work

Which issue(s) this PR fixes:
No open issues for this PR

[hyder]

Please add more explicit steps.

[Djelibeybi]

Can you please lint all your Markdown files using markdownlint, please.

[Djelibeybi]

I suggest following the same layout as the AWS development guide: https://cluster-api-aws.sigs.k8s.io/development/development.html, i.e. start with explaining the prequisites, then set up the environment, then how to commit, etc.

[joekr]

@Djelibeybi ended up moving the doc into the book like you pointed out and expanding upon the developer guide a bit.

[hyder]

feedback provided

[Djelibeybi]

This is really good, but it's missing the process to lint, test and then submit changes back upstream, which is possibly because we haven't defined that yet. If we have (or if the SIG has preferred options for each), it would be great if those could be documented.

[Djelibeybi]

Whoops, clicked the wrong button.

[Djelibeybi]

Try this:

Suggested change

	1. Install make.
	- `$ xcode-select --install` on macOS.
	- `$ sudo apt-get install build-essential` on Ubuntu Linux
	- `$ sudo dnf install make gcc` on Oracle Linux
	1. Install [Go][go]
	1. Install the required build tools for each operating system:
	- macOS: `xcode-select --install`
	- Oracle Linux: `sudo yum install make gcc`
	- Ubuntu Linux: `sudo apt-get install build-essential`
	1. Install [Go][go] by following the [installation guide](https://go.dev/doc/install).

[Djelibeybi]

The OSs are sorted alphabetically too.

[Djelibeybi]

Suggested change

	1. Install [KIND][kind]
	- `$ GO111MODULE="on" go get sigs.k8s.io/[email protected]`.
	1. Install [KIND][kind] by running the following command on all platforms: `$ GO111MODULE="on" go get sigs.k8s.io/[email protected]`.

[Djelibeybi]

Suggested change

	1. Install [Kustomize][kustomize]
	- [install instructions][kustomizelinux]
	1. Install [Kustomize][kustomize] by following the [install instructions][kustomizelinux].

[Djelibeybi]

Suggested change

	1. Install [envsubst][envsubst]
	- `$ go get github.com/a8m/envsubst/cmd/envsubst`
	1. Install [envsubst][envsubst] by running the following command on all platforms: `go get github.com/a8m/envsubst/cmd/envsubst`

[Djelibeybi]

Suggested change

	## Fork and get the source
	## Fork and clone this repository

[Djelibeybi]

Suggested change

	If you have `capoci-controller-manager` running in your management cluster,
	please scale down the deployment, otherwise running your development build will conflict with the
	currently running `capoci-controller-manager`:
	> **Note:** If you are re-using an existing management cluster that already has `capoci-controller-manager` installed, be sure to provide sufficient resources for both instances or scale down the existing instances to release resources for the new instance.

[Djelibeybi]

Suggested change

	To build, run and test all your code changes locally, copy the
	`hack/auth-config-template.yaml` file to `<path-to-your-repo>/auth-config.yml` in your
	cloned copy of the repository and modify it to match your local configuration.
	To build, run and test all your code changes locally, copy the `hack/auth-config-template.yaml` to `hack/auth-config.yml` and modify it to match your local configuration.

[Djelibeybi]

Suggested change

	Then run the following commands:
	After populating the local configuration file to suit your envornment, the following command will run the test suite:

[Djelibeybi]

Suggested change

	export AUTH_CONFIG_DIR="<path-to-your-repo>/auth-config.yaml"
	export AUTH_CONFIG_DIR="hack/auth-config.yaml"

[Djelibeybi]

Suggested change

	export TAG=<tag>
	export TAG="$(git rev-parse --short HEAD)"