Merge pull request #884 from govau/develop

Minor restructure to use GitHub documentation standards

Author: KiriHoy

FAQ.md

@@ -3,8 +3,8 @@ FAQs
 
 > This page contains frequently asked questions from our community.
 
-If you can’t find the answer to your question, you can email designsystem@digital.gov.au, post a message on the [community forum](https://community.digital.gov.au/c/designsystem) or join our conversation on
-[Slack](http://guides.service.gov.au/join-slack/).
+If you can’t find the answer to your question, you can email designsystem@dta.gov.au, post a message on the [community forum](https://community.digital.gov.au/c/designsystem) or join our conversation on
+[Slack](https://guides.service.gov.au/join-slack/).
 
 
 ## Contents

README.md

@@ -16,26 +16,29 @@ Australian Government Design System Components
 | https://auds.service.gov.au | https://auds.staging.service.gov.au |
 |                              | user: `auds`, pass: `auds`         |
 
-
 ## Contents
 
-* [How to use](#how-to-use)
+* [Installation](#installation)
 * [Frequently asked questions](#frequently-asked-questions)
 * [Checklist and browser support](#checklist-and-browser-support)
 * [Modules](#modules)
 * [Contribute](./CONTRIBUTING.md)
 * [Tests](#tests)
-* [License](#license)
+* [Support](./SUPPORT.md)
+* [Related repositories](#related-repositories)
+* [License](./LICENSE)
 
 
 ----------------------------------------------------------------------------------------------------------------------------------------------------------------
 
 
-## How to use
+## Installation
 
+### Prerequisites
 The design system components are distributed through the [npm](https://www.npmjs.com) ecosystem and can only be installed through the `npm` command.
 Npm requires [node.js](https://nodejs.org/en/) and the components needs node.js 8 or higher.
 
+### Installing modules
 To install a module make sure you have a `package.json` file in the root of your project folders. (You can generate one by running `npm init`.)
 Inside your working folder install any module and [pancake](https://github.com/govau/pancake/) will make sure you have all assets ready to use.
 
@@ -620,14 +623,10 @@ npm run test
 
 ----------------------------------------------------------------------------------------------------------------------------------------------------------------
 
-
-## License
-
-Copyright (c) Commonwealth of Australia.
-Licensed under [MIT](https://raw.githubusercontent.com/govau/design-system-components/master/LICENSE).
-
+## Related repositories
+- [govau/design-system-starter](https://github.com/govau/design-system-starter)
+- [govau/design-system-site](https://github.com/govau/design-system-site)
+- [govau/design-system-sketch-file](https://github.com/govau/design-system-sketch-file)
 
 **[⬆ back to top](#contents)**
 
-
-# };

SUPPORT.md

@@ -0,0 +1,11 @@
+# Australian Government Design System - Components - Support
+
+Stuck? Got an idea? There's several channels available to engage with the Design System community. 
+
+We'd prefer you ask your question in the open, if possible. It's likely that others have the same question - answers posted in a public forum will assist those who come after you.
+
+- [Post on our Community Forum](https://community.digital.gov.au/c/designsystem)
+- [Join our Slack Channel](https://govau-guides.slack.com/)
+- [Raise a GitHub issue](https://github.com/govau/design-system-components/issues/new/choose)
+
+As a last resort, you can email the core development team directly at [email protected]