chore: add versioning documentation (#362)

Author: jzempel

.github/API.md

@@ -12,20 +12,24 @@ This is a multi-package repo which uses [Lerna](https://lernajs.io/) to
 manage shared and cross-package dependencies. The basic repo layout
 includes:
 
-* `├── package.json` – the top-level "project" package that contains
+<!-- markdownlint-disable -->
+
+- `├── package.json` – the top-level "project" package that contains
   the dependencies and scripts needed to manage the multi-package repo.
   _This package will never be published to the registry._
-* `└─── packages/` – the folder that contains individual `@zendeskgarden`
+- `└─── packages/` – the folder that contains individual `@zendeskgarden`
   packages which are published to the registry.<br>
-  &nbsp;&nbsp;&nbsp;&nbsp;`├── .template/` – a special template package referenced by `yarn
-  new` to generate a component.<br>
+  &nbsp;&nbsp;&nbsp;&nbsp;`├── .template/` – a special template package
+  referenced by `yarn new` to generate a component.<br>
   &nbsp;&nbsp;&nbsp;&nbsp;`├── buttons/`<br>
   &nbsp;&nbsp;&nbsp;&nbsp;`├── tabs/`<br>
   &nbsp;&nbsp;&nbsp;&nbsp;`├── theming/`<br>
   &nbsp;&nbsp;&nbsp;&nbsp;`└── etc.`
 
+<!-- markdownlint-enable -->
+
 For an overview of our component architecture and APIs, view our [API
-documentation](API.md).
+documentation](../API.md).
 
 ## Versioning Workflow
 
@@ -58,12 +62,12 @@ commands are available:
 - `yarn build` to rebuild distributions across all packages.
   The build runs as part of the initial install. Operates as a facade
   over a Lerna command; operation may be modified using option
-  [flags](https://github.com/lerna/lerna#flags) (i.e.  `scope`, `since`,
+  [flags](https://github.com/lerna/lerna#flags) (i.e. `scope`, `since`,
   or `ignore`).
 - `yarn new` to generate a new React component based on a package
   template.
 
-See our [development documentation](DEVELOPMENT.md) for package
+See our [development documentation](../DEVELOPMENT.md) for package
 implementation requirements.
 
 ## Pull Request Workflow

.github/CONTRIBUTING.md

@@ -12,9 +12,9 @@
 
 ## Steps to Reproduce
 
-  1.
-  1.
-  1.
+1.
+1.
+1.
 
 <!--
   BONUS POINTS: spin up and share an example via
@@ -23,6 +23,6 @@
 
 ### Fine Print
 
-* Component: <!-- buttons -->
-* Version: <!-- your issue might already be fixed with the latest version -->
-* Browsers: all
+- Component: <!-- buttons -->
+- Version: <!-- your issue might already be fixed with the latest version -->
+- Browsers: all