From 0c442f40f1c6d77efaa26c0bb48aae361d22b3e2 Mon Sep 17 00:00:00 2001
From: Manish Garg <manishga@microsft.com>
Date: Mon, 2 Apr 2018 15:44:54 -0700
Subject: [PATCH 01/10] Initial stab at documentation cleanup

---
 ghdocs/{ => BestPractices}/Accessibility.md   |  18 +--
 .../Advanced.md}                              |   0
 .../ComponentDesign.md}                       |  10 +-
 .../{STYLING.md => BestPractices/Styling.md}  |   0
 .../{TESTING.md => BestPractices/Testing.md}  |   0
 ghdocs/{ => BestPractices}/Theming.md         |   0
 ghdocs/CONTRIBUTING.md                        |  25 -----
 ghdocs/Contributing/BugFixes.md               |  14 +++
 ghdocs/Contributing/CLA.md                    |   6 +
 ghdocs/Contributing/ChangeFiles.md            |  34 ++++++
 ghdocs/Contributing/GitBranchSetup.md         | 104 ++++++++++++++++++
 ghdocs/Contributing/NewComponent.md           |  23 ++++
 .../Fabric_Component.md}                      |   2 +-
 ghdocs/{ => Releases}/MIGRATION_TO_5.0.0.md   |   0
 .../BrowserSupport.md}                        |   0
 ghdocs/images/pull-request-checks.png         | Bin 0 -> 36893 bytes
 16 files changed, 191 insertions(+), 45 deletions(-)
 rename ghdocs/{ => BestPractices}/Accessibility.md (52%)
 rename ghdocs/{ADVANCED.md => BestPractices/Advanced.md} (100%)
 rename ghdocs/{BESTPRACTICES.md => BestPractices/ComponentDesign.md} (98%)
 rename ghdocs/{STYLING.md => BestPractices/Styling.md} (100%)
 rename ghdocs/{TESTING.md => BestPractices/Testing.md} (100%)
 rename ghdocs/{ => BestPractices}/Theming.md (100%)
 delete mode 100644 ghdocs/CONTRIBUTING.md
 create mode 100644 ghdocs/Contributing/BugFixes.md
 create mode 100644 ghdocs/Contributing/CLA.md
 create mode 100644 ghdocs/Contributing/ChangeFiles.md
 create mode 100644 ghdocs/Contributing/GitBranchSetup.md
 create mode 100644 ghdocs/Contributing/NewComponent.md
 rename ghdocs/{FABRIC_COMPONENT.md => References/Fabric_Component.md} (98%)
 rename ghdocs/{ => Releases}/MIGRATION_TO_5.0.0.md (100%)
 rename ghdocs/{BROWSERSUPPORT.md => Testing/BrowserSupport.md} (100%)
 create mode 100644 ghdocs/images/pull-request-checks.png

diff --git a/ghdocs/Accessibility.md b/ghdocs/BestPractices/Accessibility.md
similarity index 52%
rename from ghdocs/Accessibility.md
rename to ghdocs/BestPractices/Accessibility.md
index 266ae51e2f676..403864b9f29bf 100644
--- a/ghdocs/Accessibility.md
+++ b/ghdocs/BestPractices/Accessibility.md
@@ -10,28 +10,20 @@ Default color choices should conform to contrast requirements as laid out in [WC
 
 We best support high contrast in Internet Explorer 11 and Microsoft Edge. Mozilla FireFox is also supported to the extent possible barring technical constraints. Read on for more details.
 
-The recommended approach here is to use the correct elements to match your scenario.
-Sometimes, you'll have to use a similar, but not exactly right, element.
-For example, when making a custom checkbox, you can wrap it in a `<button>` element.
-This will cause it to pick up the correct colors in all three supported browsers.
+The recommended approach here is to use the semantically correct elements to match your scenario. For example, use a `<button>` element for a Button and not a `<div>`. Sometimes, you'll have to use a similar, but not exactly right, element. For example, when making a custom checkbox, you can wrap it in a `<button>` element. This will cause it to pick up the correct colors in all three supported browsers.
 
 As a backup approach, high contrast colors can be manually applied in CSS.
-These colors should ONLY be from the [System Colors](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value#System_Colors) palette.
-The logic on when to apply these colors can vary, from using media queries (see below) or using code to detect when high contrast is on.
+These colors should ONLY be from the [System Colors](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value#System_Colors) palette. The logic on when to apply these colors can vary, from using media queries (see below) or using code to detect when high contrast is on.
 
-The last approach is to use media queries with `-ms-high-contrast` to scope styles to high contrast.
-Since this only work in Internet Explorer and Microsoft Edge, it is not recommended as a general strategy.
-We use this only where necessary, for complex scenarios such as multiselect.
+The last approach is to use media queries with `-ms-high-contrast` to scope styles to high contrast. Since this only work in Internet Explorer and Microsoft Edge, it is not recommended as a general strategy. We use this only where necessary, for complex scenarios such as multiselect.
 
 Note that background images can disappear in high contrast mode. Any icons or images that are required for functionality must not be background images.
 
-In high contrast mode, color should not be the only means of conveying feedback.
-A transparent border or outline will appear in high contrast mode, a useful way of denoting focus without affecting non-high contrast visual design.
+In high contrast mode, color should not be the only means of conveying feedback. A transparent border or outline will appear in high contrast mode, a useful way of denoting focus without affecting non-high contrast visual design.
 
 ## Screen Reader
 
-Follow recommended guidelines using [ARIA](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) to insure the best support for screen readers.
-Where necessary, add in extra text only visible to the screen reader for descriptions and directions, by positioning it off screen.
+Follow recommended guidelines using [ARIA](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) to insure the best support for screen readers. Where necessary, add in extra text only visible to the screen reader for descriptions and directions, by positioning it off screen.
 
 Our primary support scenario is Microsoft Edge with Windows Narrator.
 
diff --git a/ghdocs/ADVANCED.md b/ghdocs/BestPractices/Advanced.md
similarity index 100%
rename from ghdocs/ADVANCED.md
rename to ghdocs/BestPractices/Advanced.md
diff --git a/ghdocs/BESTPRACTICES.md b/ghdocs/BestPractices/ComponentDesign.md
similarity index 98%
rename from ghdocs/BESTPRACTICES.md
rename to ghdocs/BestPractices/ComponentDesign.md
index 5991e007a5e69..840a2759ffaa2 100644
--- a/ghdocs/BESTPRACTICES.md
+++ b/ghdocs/BestPractices/ComponentDesign.md
@@ -5,12 +5,11 @@
 - The component can always provide `id`, `className`, `style`, `aria-*` and `data-*` attributes on the container of a component.
 
 - If the component represents a standard HTML element (e.g. Button), we should mix in the valid root props using the `getNativeProps`
-utility so that we can let the user use native things as expected.
+utility so that we can let the user use native functionality as expected.
 
-- If the component hosts clickable elements, there must be a way to inject `data-*` attributes onto the clickable things. This enables
-automation to be built downstream.
+- If the component hosts clickable elements, there must be a way to inject `data-*` attributes onto the clickable components. This enables test automation to be built downstream.
 
-- Interactable elements must be accessible via keyboard, mouse, and touch`. Nothing can be ONLY interactable by mouse.
+- Interactable elements must be accessible via keyboard, mouse, and touch. Nothing can be ONLY interactable by mouse.
 
 ## Build many smaller components and compose them together.
 
@@ -24,8 +23,7 @@ together. While it may be more effort to think in smaller blocks, it makes the c
 
 ## Use a .types.ts file to extract out the public contracts that should be supported and documented.
 
-A props file contains all of the interface contracts that the user should know about to use the component. It is the "contract" for the
-component. When we evaluate semversioning, we look through the changes at Props files to determine if the change is a major, minor, or
+A props file contains all of the interface contracts that the user should know about to use the component. It is the "contract" for the component. When we evaluate semversioning, we look through the changes at Props files to determine if the change is a major, minor, or
 patch.
 
 The props files are also auto documented. All JSDoc comments will be extracted and shown on the demo site for documentation.
diff --git a/ghdocs/STYLING.md b/ghdocs/BestPractices/Styling.md
similarity index 100%
rename from ghdocs/STYLING.md
rename to ghdocs/BestPractices/Styling.md
diff --git a/ghdocs/TESTING.md b/ghdocs/BestPractices/Testing.md
similarity index 100%
rename from ghdocs/TESTING.md
rename to ghdocs/BestPractices/Testing.md
diff --git a/ghdocs/Theming.md b/ghdocs/BestPractices/Theming.md
similarity index 100%
rename from ghdocs/Theming.md
rename to ghdocs/BestPractices/Theming.md
diff --git a/ghdocs/CONTRIBUTING.md b/ghdocs/CONTRIBUTING.md
deleted file mode 100644
index 212f1c6369634..0000000000000
--- a/ghdocs/CONTRIBUTING.md
+++ /dev/null
@@ -1,25 +0,0 @@
-# Contribution
-
-Office UI Fabric React is an evolving snapshot of the Office 365 Design Language's components, built with [React](https://facebook.github.io/react/).
-
-### Contribution license agreement
-For pull requests affecting fewer than 15 lines of code, you will need to sign a [Contribution License Agreement (CLA)](https://cla.microsoft.com/) before your contribution can be incorporated. To complete the CLA, you will need to submit the request via the form and then electronically sign the CLA when you receive the email containing the link to the document.
-
-This needs to only be done once for any Microsoft open source project.
-
-### Issue tracker labels
-
-We track community issues via GitHub's [issue tracker](https://github.com/OfficeDev/Office-UI-Fabric-react/issues). To help us keep track of the different areas, please use the following labels:
-
-- `accessibility` - Issues or PRs that pertain to keyboard support, high contrast mode, screen reader support, etc.
-- `bug` - Issues or PRs that address unexpected behavior or broken components.
-- `build-system` - Issues and PRs related to the build process.
-- `documentation` - Issues and PRs that pertain to the documentation included with the repository.
-- `enhancement` - Issues or PRs that address potential improvements to components.
-- `feature-request` - Issues or PRs that address ask for or add a major piece of functionality.
-- `needs-design` - Issues or PRs that need Design guidance.
-- `needs-discussion` - Issues or PRs that need discussion among the Fabric team.
-- `question` - Issues that don't necessarily require code and usually consist of clarifications.
-- `waiting-for-author` - Issues or PRs that are awaiting a repsonse from the original author.
-- `waiting-for-details` - Issues or PRs that need more details before they can be acted upon.
-- `waiting-to-merge` - PRs that are close to being merged in but are stalled.
diff --git a/ghdocs/Contributing/BugFixes.md b/ghdocs/Contributing/BugFixes.md
new file mode 100644
index 0000000000000..a376e03bcb297
--- /dev/null
+++ b/ghdocs/Contributing/BugFixes.md
@@ -0,0 +1,14 @@
+ 
+ ## Contributing bug fixes
+
+ Please use the following steps to contribute bug fixes
+
+- Setup your branch using instructions in [GitbranchSetup](./GitBranchSetup.md)
+
+- Make the code changes and test the code changes.
+
+- Run `npm run change` and provide change instructions. Please read [ChangeFiles](./ChangeFiles.md) for more details on providing change instructions.
+
+- Push the changes to your remote branch.
+
+- Create a pull request against the **OfficeDev/office-ui-fabric-react** repository.
\ No newline at end of file
diff --git a/ghdocs/Contributing/CLA.md b/ghdocs/Contributing/CLA.md
new file mode 100644
index 0000000000000..8f387bbe77fc6
--- /dev/null
+++ b/ghdocs/Contributing/CLA.md
@@ -0,0 +1,6 @@
+
+### Contribution license agreement
+
+For pull requests affecting fewer than 15 lines of code, you will need to sign a [Contribution License Agreement (CLA)](https://cla.microsoft.com/) before your contribution can be incorporated. To complete the CLA, you will need to submit the request via the form and then electronically sign the CLA when you receive the email containing the link to the document.
+
+This needs to only be done once for any Microsoft open source project.
diff --git a/ghdocs/Contributing/ChangeFiles.md b/ghdocs/Contributing/ChangeFiles.md
new file mode 100644
index 0000000000000..7baf396ec102a
--- /dev/null
+++ b/ghdocs/Contributing/ChangeFiles.md
@@ -0,0 +1,34 @@
+
+## Need for Change files
+
+When we publish new releases, we need to know what major, minor or patch changes have gone into the build. For that reason, every developer should add a change file with their checkin using the `npm run change` command.
+
+## Writing a change description
+
+Please write a change desription such that it is easy for the release manager to understand the impact of the change. When we ship out new releases, we need to build a cumulative set of **Release notes**. Those release notes are a summation of individual changes checked in. Hence, it is important that developers write clear and understandable change descriptions.
+
+## Change annotation
+
+Our builds are qualified using the [Semver](https://semver.org/) notation. Please do spend some time reading the Semver defintions.
+
+### Patch
+
+Any change that is fully backward compatible and does not have an API change should qualify as a **patch** level change. Most code bug fixes qualify as a **patch**.
+
+### Minor
+
+Following changes should require a **minor** build number change
+
+- Any API change should qualify as at least as a **minor** change. When you add a new API in a backward compatible manner. i.e. Use of the new API is optional.
+
+- When you add new functionality that is backward compatible.
+
+### Major
+
+Any changes that are not backward compatible should be qualified as **major** changes.
+
+- Any breaking API changes. i.e. API deletions, mandatory new APIs, API renames.
+
+- Addition or removal of functionality in a non backward compatible way.
+
+- A new component should qualify as a **major** change.
\ No newline at end of file
diff --git a/ghdocs/Contributing/GitBranchSetup.md b/ghdocs/Contributing/GitBranchSetup.md
new file mode 100644
index 0000000000000..0afd74beaf793
--- /dev/null
+++ b/ghdocs/Contributing/GitBranchSetup.md
@@ -0,0 +1,104 @@
+# [office-ui-fabric-react](../../../README.md) › Contributing
+
+This document describes how to setup your development environment and contribute changes to the **office-ui-fabric-react** project. This document assumes basic working knowledge with Git and related tools. We are providing instructions specific to this project.
+
+## Setup
+
+- Make sure you have a **github** account. If not, create one.
+- Install **Node.js LTS 8** or greater from thes **[Node.js website](https://nodejs.org/en/)**.
+- Install **[Git](https://git-scm.com/)**.
+- For code editing we like **[Visual Studio Code ](https://code.visualstudio.com/)**
+- For Git branch management we like **[SourceTree](https://www.atlassian.com/software/sourcetree)**
+
+## Building
+
+If you do not wish to contribute chages to the **office-ui-fabric-react** project, please follow the instructions on the [README](../README.md) page. Else, keep reading.
+
+## Creating your own fork
+
+If you wish to contribute changes back to the **office-ui-fabric-react** repository, start by creating your own fork of the repository. This is essential. This will keep the number of branches on the main repository to a small count. There are lots of developers in this project and creating lots of branches on the main repository does not scale. In your own fork, you can create as many branches as you like.
+
+- Navigate to **[Github](https://www.github.com)** with a browser and login to your github account. For the sake of this document, lets assume your account is **johndoe**.
+- Navigate to **[Office-ui-fabric-react](https://github.com/OfficeDev/office-ui-fabric-react)** repository in the same browser session.
+- Click on the **fork** button at the top right corner of the page.
+- Create the fork on your user name. Your github profile should now show **office-ui-fabric-react** as one of your repositories.
+- Create a folder on your device and clone your fork of the **office-ui-fabric-react** repository. e.g. https://github.com/**johndoe**/office-ui-fabric-react.git. Notice how your github user name is in the repository location.
+
+```
+> git clone https://github.com/johndoe/office-ui-fabric-react.git
+```
+
+## Building
+
+Next, clone and build the code.
+
+```
+- git clone https://github.com/johndoe/office-ui-fabric-react.git
+- cd packages/office-ui-fabric-react
+- npm install
+- npm run build
+- npm start
+```
+
+## Setting up the upstream repository
+
+Before starting to contribute changes, please setup your upstream repository to the primary **office-ui-fabric-react** repository.
+
+- When you run **git remote -v**, you should see only your fork in the output list
+
+```
+>git remote -v
+
+     origin  https://github.com/johndoe/office-ui-fabric-react.git (fetch)
+
+     origin  https://github.com/johndoe/office-ui-fabric-react.git (push)
+```
+
+- Map the primary **office-ui-fabric-react** repository as the upstream remote
+
+```
+>git remote add upstream https://github.com/OfficeDev/office-ui-fabric-react.git
+```
+
+- Now running **git remote -v** should show the upstream repository also
+
+```
+>git remote -v
+
+     origin  https://github.com/johndoe/office-ui-fabric-react.git (fetch)
+
+     origin  https://github.com/johndoe/office-ui-fabric-react.git (push)
+
+     upstream        https://github.com/OfficeDev/office-ui-fabric-react.git (fetch)
+
+     upstream        https://github.com/OfficeDev/office-ui-fabric-react.git (push)
+```
+
+- At this point you are ready to start branching and contributing back changes.
+
+## Making code changes and creating a pull request
+
+Create a branch from your fork and start making the code changes. Either a new component or bug fixes to existing components. We recommend using [**SourceTree**](https://www.sourcetreeapp.com/) for working in your repo. Once you are happy with the changes, and want to merge them to the main **office-ui-fabric-react** project, create a pull request from your branch directly to "OfficeDev/office-ui-fabric-react  master".
+
+Members on the **office-ui-fabric-react** core team will help merge your changes.
+
+## Merging upstream master into your fork master
+
+From time to time, your fork will get out of sync with the upstream remote. Use the following commands to get your fork up upto date.
+
+```
+git fetch upstream
+git checkout master
+git pull upstream master
+```
+
+## Merging upstream master into your current branch
+
+From time to time, your current branch will get out of sync with the upstream remote. Use the following commands to get your branch up upto date.
+
+```
+git fetch upstream
+git pull upstream master
+```
+
+All done!
diff --git a/ghdocs/Contributing/NewComponent.md b/ghdocs/Contributing/NewComponent.md
new file mode 100644
index 0000000000000..bc5b77bda924a
--- /dev/null
+++ b/ghdocs/Contributing/NewComponent.md
@@ -0,0 +1,23 @@
+  
+ ## Contributing a new component
+
+ Please use the following steps to contribute a new component
+
+- Setup your branch using instructions in [GitbranchSetup](./GitBranchSetup.md)
+
+- First create your new component in the **Experiments** project.
+
+- Test the new component.
+
+- Run `npm run change` and provide component details. Please read [ChangeFiles](./ChangeFiles.md) for more details on providing change instructions.
+
+- Push the changes to your remote branch.
+
+- Create a pull request against the **OfficeDev/office-ui-fabric-react** repository.
+
+- Push the change to master.
+
+- Seek feedback from the **Fabric core team** about the component.
+
+- Once the component is functioning in a stable fashion, move it to the main **office-ui-fabric-react** project and add yourself as the owner of this component in the [CodeOwners](https://github.com/OfficeDev/office-ui-fabric-react/blob/master/.github/CODEOWNERS) file.
+
diff --git a/ghdocs/FABRIC_COMPONENT.md b/ghdocs/References/Fabric_Component.md
similarity index 98%
rename from ghdocs/FABRIC_COMPONENT.md
rename to ghdocs/References/Fabric_Component.md
index 9e19897182b41..d3515040bbda8 100644
--- a/ghdocs/FABRIC_COMPONENT.md
+++ b/ghdocs/References/Fabric_Component.md
@@ -23,7 +23,7 @@ The Fabric component is a root wrapper component which solves 2 problems:
 
 2. The focus rectangle visibility is managed through the `is-focusVisible` css class.
 
-## Focus rectangle notes
+## Focus rectangle
 
 Focus rectangles around components should only be shown when the user presses tab or directional keys. When they press mouse buttons, focus rectangles should not be shown. The `Fabric` component that will conditionally add/remove an `is-focusVisible` class, and components rendering focus rectangles should conditionalize their visibility based on the `.ms-Fabric.is-focusVisible` parent selector.
 
diff --git a/ghdocs/MIGRATION_TO_5.0.0.md b/ghdocs/Releases/MIGRATION_TO_5.0.0.md
similarity index 100%
rename from ghdocs/MIGRATION_TO_5.0.0.md
rename to ghdocs/Releases/MIGRATION_TO_5.0.0.md
diff --git a/ghdocs/BROWSERSUPPORT.md b/ghdocs/Testing/BrowserSupport.md
similarity index 100%
rename from ghdocs/BROWSERSUPPORT.md
rename to ghdocs/Testing/BrowserSupport.md
diff --git a/ghdocs/images/pull-request-checks.png b/ghdocs/images/pull-request-checks.png
new file mode 100644
index 0000000000000000000000000000000000000000..ad9ea99eee8aa34d6ce5880ddb21b5cfed0a1ce6
GIT binary patch
literal 36893
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
Lyn(v@DE$8dZDA(g

literal 0
HcmV?d00001


From 46a544cb02467719e021f41ac2c7ffb0c2235511 Mon Sep 17 00:00:00 2001
From: Manish Garg <manishga@microsft.com>
Date: Sun, 8 Apr 2018 11:36:43 -0700
Subject: [PATCH 02/10] Doc updates first iteration

---
 CONTRIBUTING.md                               | 111 ------------
 README.md                                     |  10 +-
 ghdocs/BestPractices/Testing.md               |   2 +-
 ghdocs/Contributing/BugFixes.md               |  12 +-
 ghdocs/Contributing/Contributing.md           |  20 +++
 ghdocs/Contributing/NewComponent.md           | 158 ++++++++++++++++--
 .../{GitBranchSetup.md => Setup.md}           |   0
 ghdocs/README.md                              | 153 -----------------
 8 files changed, 177 insertions(+), 289 deletions(-)
 delete mode 100644 CONTRIBUTING.md
 create mode 100644 ghdocs/Contributing/Contributing.md
 rename ghdocs/Contributing/{GitBranchSetup.md => Setup.md} (100%)
 delete mode 100644 ghdocs/README.md

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
deleted file mode 100644
index 255d47afb7f6b..0000000000000
--- a/CONTRIBUTING.md
+++ /dev/null
@@ -1,111 +0,0 @@
-# Contributing to Office UI Fabric
-
-## Components
-Our components are a collection of small, independent, general-purpose UI components intended to be reused throughout an existing application.
-
-### Contributing new components
-We have two main buckets for our new and existing components, Experimental and Fundamental. These categories are created to notify Fabric users which components are expected to be fully supported and stable and which ones are likely to change drastically over a short period of time.
-
-### Design
-
-#### Does the component already exist?
-Before making the decision to design a new component, check to see if the pattern already exists within any current Microsoft design system including our [Adobe XD Toolkit](https://static2.sharepointonline.com/files/fabric/fabric-website/files/officeuifabric_v4.0.0.zip). If you are a Microsoft employee please check the internal version of the [Adobe XD Toolkit (Microsoft Employees)](https://microsoft.sharepoint.com/teams/OfficeUIFabric97) or if you have more in depth questions regarding any Microsoft design system, please visit our internal Microsoft [Teams channel](https://teams.microsoft.com/l/channel/19%3a73a5dbc26c9a4d8d91264611995bbdbb%40thread.skype/Fabric%2520Design?groupId=ffe264f2-14d0-48b5-9384-64f808b81294&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47).
-
-#### Is the proposed component a variant of an existing component?
-If the new component pattern you are proposing already exists, but varies slightly, then please consider creating a variant of the existing pattern. For example, if you were to create a new button that does 1 new thing for our exisiting button then we would suggest creating a variant off the original button, but containing the one additional feature.
-
-#### Qualify - Should it be a shared component?​
-If it’s a new component request, does it add value at a broad level or is it a product-specific customization?​ Product-specific customizations should be stored in local product repos. [//]: # (TODO: add line exlaining how we extend our components and also create a page for extending components)
-
-#### Does this pattern contain Microsoft Intellectual Property?
-If the new component contains Microsoft Intellectual Property, it should be considered Internal and therefore all discussions around the component should __only__ happen internally or within our [Fabric Design Teams channel](https://teams.microsoft.com/l/channel/19%3a73a5dbc26c9a4d8d91264611995bbdbb%40thread.skype/Fabric%2520Design?groupId=ffe264f2-14d0-48b5-9384-64f808b81294&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47). If the component does not contain Microsoft Intellectual Property then this component can be discussed directly on GitHub in our [issues section](https://github.com/OfficeDev/office-ui-fabric-react/issues).
-
-#### Create
-Create a new component pattern or leverage an existing component and create a variant. Use our [Adobe XD Toolkit](https://static2.sharepointonline.com/files/fabric/fabric-website/files/officeuifabric_v4.0.0.zip) as a model for how we document component patterns in Fabric. ​We require that all components have detailed usage guidelines for developers and designers who want to integrate this pattern into their respective product/project. Component should be genericized before submission as much as possible leaving out product specific colors/customizations etc.
-
-#### Review and Socialize​
-Ask for design feedback within the Fabric community through our [Fabric Design Teams channel](https://teams.microsoft.com/l/channel/19%3a73a5dbc26c9a4d8d91264611995bbdbb%40thread.skype/Fabric%2520Design?groupId=ffe264f2-14d0-48b5-9384-64f808b81294&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47). Or, schedule review with the HVC product team for review.
-Socialize component in Fabric community so other teams have visibility. ​ You can also post an issue on GitHub outlining the component request as long as it doesn't contain any Microsoft Intellectual Property.
-
-### Design Implementation
-
-#### Request the component be added to our Fabric Adobe XD toolkit.
-Submit Internal components to our [Fabric Design Teams channel](https://teams.microsoft.com/l/channel/19%3a73a5dbc26c9a4d8d91264611995bbdbb%40thread.skype/Fabric%2520Design?groupId=ffe264f2-14d0-48b5-9384-64f808b81294&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47) so a designer on our team can update our toolkit. External components can be submitted via GitHub in our [issue tracking](https://github.com/OfficeDev/office-ui-fabric-react/issues) section.
-
-### Where does the code live for this component?
-If the component has no Microsoft Intellectual Property then it belongs in our public project office-ui-fabric-react. If the component contains Microsoft Intellectual Property then it must live internally. Please reach out to our team for more information about our internal repository.
-
-### How we categorize components within the project.
-
-#### Experimental components
-Experimental components are any new components and or do not currently exist within our [Adobe XD Toolkit](https://static2.sharepointonline.com/files/fabric/fabric-website/files/officeuifabric_v4.0.0.zip). By Default, our `create-component` script will place the component folder and files in packages/experiments. new components stay in the experimental phase until a Fabric team member approves the migrations from Experimental to Fundamental. Experimental components are developed in the experiments project located in the `<root of project>packages/experiments` folder. We also view any components that were created as a prototype or proof of concept to be an experiment.
-
-#### Fundamental components
-Fundamental components are the official React representation of our [Adobe XD Toolkit](https://static2.sharepointonline.com/files/fabric/fabric-website/files/officeuifabric_v4.0.0.zip) and receive higher priority in respect to stabilization, bug fixes, accessibility, and general design resourcing. Components __cannot__ be immediately added as a Fundamental type component as it will need a period of stabilization and potential API changes. A good portion of the components are currently integrated within some of our major products such as OneDrive and SharePoint. Fundamental components are developed in the office-ui-fabric-react project and within our `<root of project>/packages/office-ui-fabric-react` folder.
-
-### Getting started coding your component
-
-#### Creating a component via the command line
-1. Open a command prompt in the root directory of your project directory.
-2. Run `npm run create-component -- --name YourAwesomeNewComponentName`
-  * Our components use the Pascal Case naming convention.
-
-#### Creating a component manually.
-1. From the root of the project, navigate to `packages/experiments/src/components/`
-  * Note: All new components should start off as an experimental component in the experiment package. As the component matures, and the Fabric team signs off then we can migrate it over to our main component project.
-2. Create a new folder here with your component name
-  * Our components use the Pascal Case naming convention.
-  * In this example the component will be called `ExcitingNewComponent`.
-3. Create a `ExcitingNewComponent.types.ts` file that will contain an interface for your props
-  * Import React
-    * `import * as React from 'react'`;
-  * Import ExcitingNewComponent
-    * `import { ExcitingNewComponent } from './ExcitingNewComponent'`;
-    * Note: This class and file don't exist yet but they will during step 4 of this small tutorial.
-  * Create an empty interface `IExcitingNewComponent`
-    * `export interface IExcitingNewComponent {}`
-  * Add your props interface to this file.
-    * `export interface IExcitingNewComponentProps extends React.Props<ExcitingNewComponent> { … Props }`
-  * Create and export an interface for ExcitingNewComponent styles.
-```
-    export interface I{{componentName}}Styles {
-      /**
-      * Style for the root element
-      */
-      root?: IStyle;
-    }
-```
-4. Create a react file, `ExcitingNewComponent.tsx`.
-  * Import React
-    * `import * as React from 'react';`
-  * Import BaseComponent
-    * `import { BaseComponent } from '../../Utilities';`
-  * Import IExcitingNewComponentProps
-    * `import { IExcitingNewComponentProps } from './ExcitingNewComponent.types';`
-  * Add your class to this file.
-    * Add the following example class
-    * `export class ExcitingNewComponent extends BaseComponent<IExcitingNewComponentProps, {}> { };`
-5. Create a class names file `ExcitingNewComponent.classNames.ts`
-  * Import memoizeFunction.
-    * `import { memoizeFunction } from '../../Utilities';`
-  * Import mergeStyles.
-    * `import { mergeStyleSets } from '../../Styling';`
-  * Import ExcitingNewComponent.
-    * `import { IExcitingNewComponentStyles } from './ExcitingNewComponent.types';`
-  * Create and export an interface for your class names.
-```
-    export interface IExcitingNewComponentClassNames {
-      /**
-      * Root html container for this component.
-      */
-      root?: string;
-    }
-```
-  * Create and export getClassNames
-```
-    export const getClassNames = memoizeFunction((): IExcitingNewComponentClassNames => {
-      return mergeStyleSets({
-        root: []
-      });
-    });
-```
\ No newline at end of file
diff --git a/README.md b/README.md
index 5ecb5cdc068ec..5c779628b92d0 100644
--- a/README.md
+++ b/README.md
@@ -51,7 +51,7 @@ ReactDOM.render(
 
 ## Browser support
 
-Fabric React supports many commonly used browsers. See the [browser support doc](https://github.com/OfficeDev/office-ui-fabric-react/blob/master/ghdocs/BROWSERSUPPORT.md) for more information.
+Fabric React supports many commonly used browsers. See the [browser support doc](https://github.com/OfficeDev/office-ui-fabric-react/blob/master/ghdocs/Testing/BrowserSupport.md) for more information.
 
 ## Server-side rendering
 
@@ -125,15 +125,17 @@ In Jest:
 
 ## Advanced usage
 
-For advanced usage including info about module vs. path-based imports, using an AMD bundler like Require, and deployment features, see our [advanced documentation](https://github.com/OfficeDev/office-ui-fabric-react/blob/master/ghdocs/ADVANCED.md).
+For advanced usage including info about module vs. path-based imports, using an AMD bundler like Require, and deployment features, see our [advanced documentation](https://github.com/OfficeDev/office-ui-fabric-react/blob/master/ghdocs/BestPracties/ADVANCED.md).
 
 ## Contribute to Fabric React
 
 Please take a look at our [contribution guidelines](https://github.com/OfficeDev/office-ui-fabric-react/blob/master/ghdocs/CONTRIBUTING.md) for more info.
 
+Please read [Bug fixes](https://github.com/OfficeDev/office-ui-fabric-react/blob/master/ghdocs/Contributing/BugFixes.md) and [New component](https://github.com/OfficeDev/office-ui-fabric-react/blob/master/ghdocs/Contributing/NewComponent.md)
+
 ## Building the repo
 
-Before you get started, **make sure you have [node.js](https://nodejs.org/) and [git](https://git-scm.com/) installed.**
+Before you get started, **make sure you have read the [Git branch setup instrucions](https://github.com/OfficeDev/office-ui-fabric-react/blob/master/ghdocs/Contributing/Setup.md)**
 
 To view the documentation including examples, contracts, component status, and to add functionality or fix issues locally, you can:
 
@@ -149,7 +151,7 @@ To build individual packages within the `packages/*/` folders, you can use `npm
 
 ## Testing
 
-For testing see our [testing documentation](https://github.com/OfficeDev/office-ui-fabric-react/blob/master/ghdocs/TESTING.md).
+For testing see our [testing documentation](https://github.com/OfficeDev/office-ui-fabric-react/blob/master/ghdocs/BestPractices/Testing.md).
 
 ## Advanced building tips
 
diff --git a/ghdocs/BestPractices/Testing.md b/ghdocs/BestPractices/Testing.md
index 7b0139d6d60cb..f042d80be30d0 100644
--- a/ghdocs/BestPractices/Testing.md
+++ b/ghdocs/BestPractices/Testing.md
@@ -4,7 +4,7 @@
 
 Our tests are built using [Jest](https://facebook.github.io/jest/). This allows us to run tests in a node environment, and simulates the browser using jsdom.
 
-For snapshot testing, we use `react-test-renderer` and Jest apis.
+For snapshot testing, we use `react-test-renderer` and `Jest apis`.
 
 For creating React functional tests, we use [Enzyme](http://airbnb.io/enzyme/) to automate rendering. This gives us helpers for mounting a component, accessing elements rendered by it, and simulating clicks and keypresses.
 
diff --git a/ghdocs/Contributing/BugFixes.md b/ghdocs/Contributing/BugFixes.md
index a376e03bcb297..4243cd6ec65c5 100644
--- a/ghdocs/Contributing/BugFixes.md
+++ b/ghdocs/Contributing/BugFixes.md
@@ -1,14 +1,10 @@
- 
+
  ## Contributing bug fixes
 
  Please use the following steps to contribute bug fixes
 
-- Setup your branch using instructions in [GitbranchSetup](./GitBranchSetup.md)
-
-- Make the code changes and test the code changes.
-
-- Run `npm run change` and provide change instructions. Please read [ChangeFiles](./ChangeFiles.md) for more details on providing change instructions.
+* Setup your branch using instructions in [GitbranchSetup](./GitBranchSetup.md)
 
-- Push the changes to your remote branch.
+* Code and test the bug fix
 
-- Create a pull request against the **OfficeDev/office-ui-fabric-react** repository.
\ No newline at end of file
+* Test the fix and make sure all the tests are passing
\ No newline at end of file
diff --git a/ghdocs/Contributing/Contributing.md b/ghdocs/Contributing/Contributing.md
new file mode 100644
index 0000000000000..5df99d76fc624
--- /dev/null
+++ b/ghdocs/Contributing/Contributing.md
@@ -0,0 +1,20 @@
+
+ ## Contributing to Office UI Fabric
+
+Please use the following steps to contribute a new component or a bug fix to the Office UI Fabric project.
+
+* Setup your branch using instructions in [GitbranchSetup](./GitBranchSetup.md).
+
+* Read [BugFix](./BugFixes.md) guide for preparing a bug fix and the [New Component](./NewComponent.md) guide for building a new component.
+
+* Run `npm run change` and provide component details. Please read the [ChangeFiles](./ChangeFiles.md) document for more details on providing change instructions.
+
+* Push the changes to your remote branch.
+
+* Create a pull request against the **OfficeDev/office-ui-fabric-react** repository.
+
+* Seek feedback from the **Fabric core team** about the bug fix or the new component. We are constantly reviewing and helping merge pull requests. In case of a bug fix make sure to seek feedback from the component owner specified in the [Code Owners](../../.github/CODEOWNERS) file by tagging them on the pull request.
+
+* Once feedback is received, make sure all tests are passing. Add new tests when applicable.
+
+* Complete the pull request.
\ No newline at end of file
diff --git a/ghdocs/Contributing/NewComponent.md b/ghdocs/Contributing/NewComponent.md
index bc5b77bda924a..3bb0fb09ccd0a 100644
--- a/ghdocs/Contributing/NewComponent.md
+++ b/ghdocs/Contributing/NewComponent.md
@@ -1,23 +1,157 @@
-  
- ## Contributing a new component
+# Contributing a new component to Office UI Fabric
 
- Please use the following steps to contribute a new component
+## Components
+Our components are a collection of small, independent, general-purpose UI components intended to be reused throughout an application.
 
-- Setup your branch using instructions in [GitbranchSetup](./GitBranchSetup.md)
+### Contributing new components
+We have two main buckets for components, **Experimental** and **Fundamental**. These categories are created to notify Fabric users which components are expected to be fully supported and stable and which ones are likely to change drastically over a short period of time.
 
-- First create your new component in the **Experiments** project.
+### Questions to ask before starting to build a new component
 
-- Test the new component.
+#### Does the component already exist?
+Before making the decision to design a new component, check to see if the pattern already exists within any current Microsoft design system including our [Adobe XD Toolkit](https://static2.sharepointonline.com/files/fabric/fabric-website/files/officeuifabric_v4.0.0.zip). Please feel free to open Github issues to clarify doubts.
 
-- Run `npm run change` and provide component details. Please read [ChangeFiles](./ChangeFiles.md) for more details on providing change instructions.
+If you are a Microsoft employee please check the internal version of the [Adobe XD Toolkit (Microsoft Employees)](https://microsoft.sharepoint.com/teams/OfficeUIFabric97) or if you have more in depth questions regarding any Microsoft design system, please visit our internal Microsoft [Teams channel](https://teams.microsoft.com/l/channel/19%3a73a5dbc26c9a4d8d91264611995bbdbb%40thread.skype/Fabric%2520Design?groupId=ffe264f2-14d0-48b5-9384-64f808b81294&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47).
 
-- Push the changes to your remote branch.
+#### Is the proposed component a variant of an existing component?
+If the new component pattern you are proposing already exists, but varies slightly, then please consider creating a variant of the component. For example, if you were to create a new button that does one new thing for our exisiting button then we would suggest creating a variant off the original button, but containing the one additional feature. The **Button** component is a good example of this. It has multiple variants like the **ActionButton**, **PrimaryButton**, **CommandBarButton** each of which is a very small component in itself. They all use the **BaseButton** for the core implementation but apply specific variations.
 
-- Create a pull request against the **OfficeDev/office-ui-fabric-react** repository.
+#### Should it be a shared component?​
+If it’s a new component request, does it add value at a broad level or is it a product-specific customization?​ Product-specific customizations should be stored in local product repos.
 
-- Push the change to master.
+#### Does this pattern contain Microsoft Intellectual Property?
+If the new component contains Microsoft Intellectual Property, it should be considered Internal and therefore all discussions around the component should __only__ happen internally or within our [Fabric Design Teams channel](https://teams.microsoft.com/l/channel/19%3a73a5dbc26c9a4d8d91264611995bbdbb%40thread.skype/Fabric%2520Design?groupId=ffe264f2-14d0-48b5-9384-64f808b81294&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47). If the component does not contain Microsoft Intellectual Property then this component can be discussed directly on GitHub in our [issues section](https://github.com/OfficeDev/office-ui-fabric-react/issues).
 
-- Seek feedback from the **Fabric core team** about the component.
+### Create
+Create a new component pattern or leverage an existing component and create a variant. Use our [Adobe XD Toolkit](https://static2.sharepointonline.com/files/fabric/fabric-website/files/officeuifabric_v4.0.0.zip) as a model for how we document component patterns in Fabric. ​We require that all components have detailed usage guidelines for developers and designers who want to integrate this pattern into their respective product/project. Component should be genericized before submission as much as possible leaving out product specific colors/customizations etc.
 
-- Once the component is functioning in a stable fashion, move it to the main **office-ui-fabric-react** project and add yourself as the owner of this component in the [CodeOwners](https://github.com/OfficeDev/office-ui-fabric-react/blob/master/.github/CODEOWNERS) file.
+### Review and Socialize​
+Ask for design feedback within the Fabric community through our [Fabric Design Teams channel](https://teams.microsoft.com/l/channel/19%3a73a5dbc26c9a4d8d91264611995bbdbb%40thread.skype/Fabric%2520Design?groupId=ffe264f2-14d0-48b5-9384-64f808b81294&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47). Or, schedule review with the HVC product team for review. Socialize component in Fabric community so other teams have visibility. ​You can also post an issue on GitHub outlining the component request as long as it doesn't contain any Microsoft Intellectual Property.
 
+### Design Implementation
+
+#### Request the component be added to our Fabric Adobe XD toolkit.
+Submit Internal components to our [Fabric Design Teams channel](https://teams.microsoft.com/l/channel/19%3a73a5dbc26c9a4d8d91264611995bbdbb%40thread.skype/Fabric%2520Design?groupId=ffe264f2-14d0-48b5-9384-64f808b81294&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47) so a designer on our team can update our toolkit. External components can be submitted via GitHub in our [issue tracking](https://github.com/OfficeDev/office-ui-fabric-react/issues) section.
+
+### Where does the code live for this component?
+If the component has no Microsoft Intellectual Property then it belongs in our public project office-ui-fabric-react. If the component contains Microsoft Intellectual Property then it must live internally. Please reach out to our team for more information about our internal repository.
+
+### Component categorization and lifecycle
+
+#### Component maturity lifecycle
+
+Before you start coding up your component, it is important to understand the lifecycle of a component.
+
+* All new components should start in the **Experimental** category. Please read the **Experimental components** section below for more details.
+
+* Once the component has been designed, developed and tested it can be deemed ready for promotion to the **Fundamental components** category. Please note, these components are widely used and changes can affect a lot of products.
+
+* Once you feel your component is ready to be promoted to become a **Fundamental component**, please request for a review with a Fabric core members. From outside Microsoft, you can do this through a [GitHub issue](https://github.com/OfficeDev/office-ui-fabric-react/issues).
+
+* Once the review is complete, you should be able to promote your component to the **Fundamental components** category. That is a big milestone.
+
+#### Experimental components
+Experimental components are any new components that do not currently exist within our [Adobe XD Toolkit](https://static2.sharepointonline.com/files/fabric/fabric-website/files/officeuifabric_v4.0.0.zip). By default, our `create-component` script will place the component folder and files in `packages/experiments`. New components stay in the experimental phase until a Fabric core team member approves the migrations from Experimental to Fundamental. Experimental components are developed in the experiments project located in the `<root of project>packages/experiments` folder. We also view any components that were created as a prototype or proof of concept.
+
+#### Fundamental components
+Fundamental components are the official React representation of our [Adobe XD Toolkit](https://static2.sharepointonline.com/files/fabric/fabric-website/files/officeuifabric_v4.0.0.zip) and receive higher priority in respect to stabilization, bug fixes, accessibility and general design resourcing. Components __cannot__ be immediately added as a Fundamental type component as it will need a period of stabilization and API review. All components should always start off as Experimental. A good portion of the Fundamental components are currently integrated within some of our major products such as OneDrive, SharePoint and Outlook. Fundamental components are developed in the office-ui-fabric-react project in the `<root of project>/packages/office-ui-fabric-react` folder.
+
+### Start coding your component
+
+#### Creating a component via the command line
+1. This is the recommended way of creating a new component.
+3. Open a command prompt in the root directory of your project directory.
+2. Run `npm run create-component -- --name ExcitingNewComponent`.
+
+#### Creating a component manually
+1. From the root of the project, navigate to `packages/experiments/src/components/`
+2. Create a new folder here with your component name
+  * Our components use the Pascal Case naming convention.
+  * In this example the component will be called `ExcitingNewComponent`.
+3. Create a `ExcitingNewComponent.types.ts` file that will contain an interface for your component props
+
+  * @todo: review
+  * Import React
+    * `import * as React from 'react'`;
+  * Import ExcitingNewComponent
+    * `import { ExcitingNewComponent } from './ExcitingNewComponent'`;
+    * Note: This class and file don't exist yet but they will during step 4 of this small tutorial.
+  * Create an empty interface `IExcitingNewComponent`
+    * `export interface IExcitingNewComponent {}`
+  * Add your props interface to this file.
+    * `export interface IExcitingNewComponentProps extends React.Props<ExcitingNewComponent> { … Props }`
+  * Create and export an interface for ExcitingNewComponent styles.
+
+```ts
+import * as React from 'react';
+import { ExcitingNewComponent } from './ExcitingNewComponent';
+import { IStyle } from '../../Styling';
+
+export interface IExcitingNewComponent {
+}
+
+export interface IExcitingNewComponentProps extends React.Props<ExcitingNewComponent> {
+  /**
+  * All props for your component are to be defined here.
+  */
+  componentRef?: (component: IExcitingNewComponent) => void;
+}
+```
+
+4. Create a react file, `ExcitingNewComponent.tsx`.
+
+```ts
+import * as React from 'react';
+import { BaseComponent } from '../../Utilities';
+import { IExcitingNewComponentProps } from './ExcitingNewComponent.types';
+
+export class ExcitingNewComponent extends BaseComponent <IExcitingNewComponentProps, {}> {
+  public render() {
+    return(
+      <div>Hello World!</div>
+    );
+  }
+}; // @todo: this ; needs to be removed
+```
+
+5. Create a class names file `ExcitingNewComponent.classNames.ts`
+
+```ts
+import { memoizeFunction } from '../../Utilities';
+import { mergeStyleSets} from '../../Styling';
+
+export interface IExcitingNewComponentStyles {
+   /**
+   * Style for the root element in the default enabled/unchecked state.
+   */
+  root?: IStyle;
+}
+
+export interface IExcitingNewComponentNames {
+	/**
+	* Root html container for this component.
+	*/
+	root?: string;
+}
+
+export const getClassNames = memoizeFunction((): IExcitingNewComponentNames => {
+	return mergeStyleSets({
+		root: []
+	});
+});
+```
+
+6. Create an exports file `index.ts`
+
+```ts
+export * from './ExcitingNewComponent';
+export * from './ExcitingNewComponent.types';
+```
+
+### Unit tests and screener tests
+
+For any new component you should think of adding **Unit tests**, **React functional tests** and **Screener tests** to prevent regressions.
+
+### Code Owners
+
+Add yourself to the [Code owners file](../../,github/CODEOWNERS).
\ No newline at end of file
diff --git a/ghdocs/Contributing/GitBranchSetup.md b/ghdocs/Contributing/Setup.md
similarity index 100%
rename from ghdocs/Contributing/GitBranchSetup.md
rename to ghdocs/Contributing/Setup.md
diff --git a/ghdocs/README.md b/ghdocs/README.md
deleted file mode 100644
index 947263d99f0df..0000000000000
--- a/ghdocs/README.md
+++ /dev/null
@@ -1,153 +0,0 @@
-## Overview
-In this tutorial, let's build a simple React app with an Office UI Fabric React DocumentCard.
-
-## Prerequisites
-### Node.js and npm
-Install [Node.js and npm](https://nodejs.org/en/) if you haven't already installed in your machine. It is recommended you at least install node `version 4.x.x` and npm `version 3.x.x`.
-
->You can check your node and npm version by running `node -v` and `npm -v` respectively.
-
-### create-react-app package
-We will use [Create React App](https://facebook.github.io/react/blog/2016/07/22/create-apps-with-no-configuration.html) to quickly create a React app for this tutorial.
-
-Once node and npm is installed, type the following command in a console to install the `create-React-app` npm package.
-
-```
-npm install -g create-react-app
-```
-
-### Visual Studio Code
-Download and install [Visual Studio Code](https://code.visualstudio.com/).
-
->We will use Visual Studio Code as our code editor for this tutorial. Feel free to use your favorite code editor of choice if you do not want to use Visual Studio Code.
-
-## Step 1: Create react app
-In a console, type the following command to create a simple React app.
-
-```
-create-react-app documentcardbasic-demo
-```
-
-This will install the required depedencies and scaffold a simple React app.
-
-![create-react-app command completed](./images/create-react-app-created.png)
-
-Once its complete, navigate to the `documentcardbasic-demo` folder.
-
-```
-cd documentcardbasic-demo
-```
-
-Type the following command to launch the React app in your browser.
-
-```
-npm start
-```
-
-![create-react-app preview in browser](./images/create-react-app-preview.png)
-
-## Step 2: Install office-ui-fabric-react package
-To use Fabric React in your project, you will need to first install the `office-ui-fabric-react` npm package. Type the following in the console to install the package:
-
-```
-npm install office-ui-fabric-react --save
-```
-
->If you have `npm start` command still running, terminate the command by pressing `Ctrl+C`.
-
-## Step 3: Add DocumentCardBasic component
-Open the `documentcardbasic-demo` project folder in Visual Studio Code.
-
-Open the file `src\App.js` and replace the existing code inside `render` method to only return the `DocumentCard` component:
-
-```jsx
-<div>
-  <DocumentCard onClickHref='http://bing.com'>
-      <DocumentCardPreview
-        previewImages={ [
-          {
-            previewImageSrc: require('./documentpreview.png'),
-            iconSrc: require('./iconppt.png'),
-            width: 318,
-            height: 196,
-            accentColor: '#ce4b1f'
-          }
-        ] }
-      />
-      <DocumentCardTitle title='Revenue stream proposal fiscal year 2016 version02.pptx'/>
-      <DocumentCardActivity
-        activity='Created Feb 23, 2016'
-        people={
-          [
-            { name: 'Kat Larrson', profileImageSrc: require('./avatarkat.png') }
-          ]
-        }
-        />
-    </DocumentCard>
-</div>
-```
-`DocumentCard` component contains the `DocumentCardPreview`, `DocumentCardTitle` and `DocumentCardActivity` components that help you describe the document card.
-
-Since `office-ui-fabric-react` is a npm module, we will need to import the document card component in the `App` component.
-
-Add the following import statement at the top of the `src\App.js` file just below `import './App.css'`:
-
-```js
-import {
-  DocumentCard,
-  DocumentCardPreview,
-  DocumentCardTitle,
-  DocumentCardActivity
-} from 'office-ui-fabric-react/lib/DocumentCard';
-```
-
-Notice how we import only the specific component module from `lib` folder instead of importing the entire `office-ui-fabric-react` module.
-
-Save the `src\App.js` file.
-
-Below is an example of how you can similarly import other components:
-
-```js
-import { Button } from 'office-ui-fabric-react/lib/Button';
-```
-
-Open `index.html` file.
-
-Fabric React components provide support for Left-to-Right (LTR) and Right-to-Left (RTL) rendering out of the box.
-
-You can specify the default direction in your `index.html`. Add the `dir` attribute with the value `ltr` to the `<html>` element:
-
-```html
-<html lang="en" dir="ltr">
-```
-
-Load Office UI Fabric styles by linking to the Office UI Fabric CDN. Add the following to the `<head`> element:
-
-```html
-<link rel="stylesheet" href="https://static2.sharepointonline.com/files/fabric/office-ui-fabric-core/9.2.0/css/fabric.min.css">
-```
-
-Save the file.
-
-Copy the following images from GitHub to `src` folder.
-* [avatarkat.png](./images/avatarkat.png)
-* [iconppt.png](./images/iconppt.png)
-* [documentpreview.png](./images/documentpreview.png)
-
-## Step 4: Preview document card
-Switch to the console and type the following to preview your app in the browser:
-
-```
-npm start
-```
-
-You should see the document card component in your app.
-
-![DocumentCard preview](./images/react-app-doccard-preview.png)
-
-## Next steps
-Congratulations! You have successfully built a simple React app with an Office UI Fabric React DocumentCard.
-
-As next steps, try using other components like `DetailsLists`, `Callout` etc.,
-
-

From c81fed66a83104b96daf56bb4746fd2796940e87 Mon Sep 17 00:00:00 2001
From: Manish Garg <manishga@microsft.com>
Date: Sun, 8 Apr 2018 21:29:23 -0700
Subject: [PATCH 03/10] Some more updates

---
 README.md                       | 12 +++++-------
 ghdocs/Contributing/BugFixes.md |  4 ++--
 2 files changed, 7 insertions(+), 9 deletions(-)

diff --git a/README.md b/README.md
index 5c779628b92d0..3093987f07682 100644
--- a/README.md
+++ b/README.md
@@ -116,7 +116,7 @@ responsiveLib.setResponsiveMode(responsiveLib.ResponsiveMode.large);
 You'll also want to mock out requiring `.scss` files.
 In Jest:
 
-```javascript
+```js
   moduleNameMapper: {
     // jest-style-mock.js should just contain module.exports = {};
     '\\.(scss)$': path.resolve(__dirname, 'jest-style-mock.js'),
@@ -127,15 +127,13 @@ In Jest:
 
 For advanced usage including info about module vs. path-based imports, using an AMD bundler like Require, and deployment features, see our [advanced documentation](https://github.com/OfficeDev/office-ui-fabric-react/blob/master/ghdocs/BestPracties/ADVANCED.md).
 
-## Contribute to Fabric React
-
-Please take a look at our [contribution guidelines](https://github.com/OfficeDev/office-ui-fabric-react/blob/master/ghdocs/CONTRIBUTING.md) for more info.
+## Contribute to Office UI Fabric React
 
-Please read [Bug fixes](https://github.com/OfficeDev/office-ui-fabric-react/blob/master/ghdocs/Contributing/BugFixes.md) and [New component](https://github.com/OfficeDev/office-ui-fabric-react/blob/master/ghdocs/Contributing/NewComponent.md)
+Please take a look at our [contribution guidelines](./ghdocs/Contributing/Contributing.md) for more info. Also read [Contribute Bug fixes](./ghdocs/Contributing/BugFixes.md) and [Contribute New component](./ghdocs/Contributing/NewComponent.md).
 
 ## Building the repo
 
-Before you get started, **make sure you have read the [Git branch setup instrucions](https://github.com/OfficeDev/office-ui-fabric-react/blob/master/ghdocs/Contributing/Setup.md)**
+Before you get started, **make sure you have read the [Git branch setup instrucions](./ghdocs/Contributing/Setup.md)**
 
 To view the documentation including examples, contracts, component status, and to add functionality or fix issues locally, you can:
 
@@ -151,7 +149,7 @@ To build individual packages within the `packages/*/` folders, you can use `npm
 
 ## Testing
 
-For testing see our [testing documentation](https://github.com/OfficeDev/office-ui-fabric-react/blob/master/ghdocs/BestPractices/Testing.md).
+For testing see our [testing documentation](./ghdocs/BestPractices/Testing.md).
 
 ## Advanced building tips
 
diff --git a/ghdocs/Contributing/BugFixes.md b/ghdocs/Contributing/BugFixes.md
index 4243cd6ec65c5..17e14279d3f06 100644
--- a/ghdocs/Contributing/BugFixes.md
+++ b/ghdocs/Contributing/BugFixes.md
@@ -5,6 +5,6 @@
 
 * Setup your branch using instructions in [GitbranchSetup](./GitBranchSetup.md)
 
-* Code and test the bug fix
+* Code and test the bug fix.
 
-* Test the fix and make sure all the tests are passing
\ No newline at end of file
+* Test the fix and make sure all the tests are passing.
\ No newline at end of file

From 86a6df9b35495814e0d8b16c7e8af503206ae009 Mon Sep 17 00:00:00 2001
From: Manish Garg <manishga@microsft.com>
Date: Mon, 9 Apr 2018 15:04:56 -0700
Subject: [PATCH 04/10] Added FAQ

---
 FAQ.md | 43 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 FAQ.md

diff --git a/FAQ.md b/FAQ.md
new file mode 100644
index 0000000000000..20b7db48c4357
--- /dev/null
+++ b/FAQ.md
@@ -0,0 +1,43 @@
+# [Office UI Fabric React FAQ](http://dev.office.com/fabric)
+
+## Q. What is Office UI Fabric React?
+
+Fabric React is a responsive, mobile-first, open-source collection of robust components designed to make it quick and simple for you to create web experiences using the `Office Design Language`.
+
+## Q. Who uses Office UI Fabric React?
+
+React components from Office UI Fabric React are used by many teams accross O365 and Microsoft for building their experiences. Some examples are Sharepoint, OneDrive, Outlook, VisualStudio Online, ...
+
+These components are also used by third party developers buiding extensiblity components using the SharePoint Framework.
+
+## Q. How do I get started with Office UI Fabric React?
+
+Start with our [README](./README.md) document.
+
+## Q. Where is the official website located?
+
+http://dev.office.com/fabric
+
+## Q. Can I contribute to Office UI Fabric React?
+
+Office UI Fabric React is an open-source distributed project. Lots of developers from inside and outside Microsoft contribute to this project. We highly encourage contributions. There is a core team that works hard to stay on top of the issues and pull requests.
+
+## Q. Why should I contribute?
+
+Office UI Fabric React is an open-source distributed project. If you are building a new app inside O365 or Microsoft, this project will potentially save you lots of time, resources and headaches. We encourage all developers who use Fabric React to return a small amount to the community. If you notice bugs, we encourage you to not only open an issue on it but also help fix it. If you have a component that you believe others should use, feel motivated and encouraged to contribute that component back to the community. Sharing is caring. Many developers contribute outside their primary job responsibilities. Additionally, there is plenty to learn. We use a lot of best practices used in the industry. Learning those can  help you in your career.
+
+## Q. How do I communicate with a Fabric React core team member?
+
+We have a very active community both outside and inside Microsoft. Please use the Microsoft [Teams channel](https://teams.microsoft.com/l/channel/19%3a73a5dbc26c9a4d8d91264611995bbdbb%40thread.skype/Fabric%2520Design?groupId=ffe264f2-14d0-48b5-9384-64f808b81294&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47) for communication from within Microsoft. And a [GitHub issue](https://github.com/OfficeDev/office-ui-fabric-react/issues) from outside Microsoft. We triage these issues at least once a week.
+
+## Q. How do I contribute to Office UI Fabric React?
+
+Start by reading our [Contributing](./ghdocs/Contributing/Contributing.md) document. Please point out any missing or incorrect details.
+
+## Q. Can I become a part of the Fabric core team?
+
+Yes, you totally can. You will need to help out with reviewing pull requests and triaging and fixing issues. For now, only Microsoft employees can be a part of the core team. We are looking into changing that policy to allow non-Microsoft folks to be a part of the core team.
+
+## Q. My pull request has been hanging for a long time. What do I do?
+
+We are very proactive and work hard to keep the outstanding pull request count low. But if your pull request is non-trivial and stuck for a long time, please feel free to tag the pull request that it has been hanging for long and you need help.
\ No newline at end of file

From 82e8457edf7af3657eb53405627d709e63571a37 Mon Sep 17 00:00:00 2001
From: Manish Garg <manishga@microsft.com>
Date: Mon, 9 Apr 2018 15:18:43 -0700
Subject: [PATCH 05/10] Fixed some links

---
 FAQ.md                          | 20 ++++++++++----------
 README.md                       |  4 ++--
 ghdocs/Contributing/BugFixes.md |  2 +-
 3 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/FAQ.md b/FAQ.md
index 20b7db48c4357..82e26aac5f1e3 100644
--- a/FAQ.md
+++ b/FAQ.md
@@ -1,43 +1,43 @@
 # [Office UI Fabric React FAQ](http://dev.office.com/fabric)
 
-## Q. What is Office UI Fabric React?
+## *Q. What is Office UI Fabric React?*
 
 Fabric React is a responsive, mobile-first, open-source collection of robust components designed to make it quick and simple for you to create web experiences using the `Office Design Language`.
 
-## Q. Who uses Office UI Fabric React?
+## *Q. Who uses Office UI Fabric React?*
 
 React components from Office UI Fabric React are used by many teams accross O365 and Microsoft for building their experiences. Some examples are Sharepoint, OneDrive, Outlook, VisualStudio Online, ...
 
 These components are also used by third party developers buiding extensiblity components using the SharePoint Framework.
 
-## Q. How do I get started with Office UI Fabric React?
+## *Q. How do I get started with Office UI Fabric React?*
 
 Start with our [README](./README.md) document.
 
-## Q. Where is the official website located?
+## *Q. Where is the official website located?*
 
 http://dev.office.com/fabric
 
-## Q. Can I contribute to Office UI Fabric React?
+## *Q. Can I contribute to Office UI Fabric React?*
 
 Office UI Fabric React is an open-source distributed project. Lots of developers from inside and outside Microsoft contribute to this project. We highly encourage contributions. There is a core team that works hard to stay on top of the issues and pull requests.
 
-## Q. Why should I contribute?
+## *Q. Why should I contribute?*
 
 Office UI Fabric React is an open-source distributed project. If you are building a new app inside O365 or Microsoft, this project will potentially save you lots of time, resources and headaches. We encourage all developers who use Fabric React to return a small amount to the community. If you notice bugs, we encourage you to not only open an issue on it but also help fix it. If you have a component that you believe others should use, feel motivated and encouraged to contribute that component back to the community. Sharing is caring. Many developers contribute outside their primary job responsibilities. Additionally, there is plenty to learn. We use a lot of best practices used in the industry. Learning those can  help you in your career.
 
-## Q. How do I communicate with a Fabric React core team member?
+## *Q. How do I communicate with a Fabric React core team member?*
 
 We have a very active community both outside and inside Microsoft. Please use the Microsoft [Teams channel](https://teams.microsoft.com/l/channel/19%3a73a5dbc26c9a4d8d91264611995bbdbb%40thread.skype/Fabric%2520Design?groupId=ffe264f2-14d0-48b5-9384-64f808b81294&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47) for communication from within Microsoft. And a [GitHub issue](https://github.com/OfficeDev/office-ui-fabric-react/issues) from outside Microsoft. We triage these issues at least once a week.
 
-## Q. How do I contribute to Office UI Fabric React?
+## *Q. How do I contribute to Office UI Fabric React?*
 
 Start by reading our [Contributing](./ghdocs/Contributing/Contributing.md) document. Please point out any missing or incorrect details.
 
-## Q. Can I become a part of the Fabric core team?
+## *Q. Can I become a part of the Fabric core team?*
 
 Yes, you totally can. You will need to help out with reviewing pull requests and triaging and fixing issues. For now, only Microsoft employees can be a part of the core team. We are looking into changing that policy to allow non-Microsoft folks to be a part of the core team.
 
-## Q. My pull request has been hanging for a long time. What do I do?
+## *Q. My pull request has been hanging for a long time. What do I do?*
 
 We are very proactive and work hard to keep the outstanding pull request count low. But if your pull request is non-trivial and stuck for a long time, please feel free to tag the pull request that it has been hanging for long and you need help.
\ No newline at end of file
diff --git a/README.md b/README.md
index 3093987f07682..8c5bc64cb385c 100644
--- a/README.md
+++ b/README.md
@@ -51,7 +51,7 @@ ReactDOM.render(
 
 ## Browser support
 
-Fabric React supports many commonly used browsers. See the [browser support doc](https://github.com/OfficeDev/office-ui-fabric-react/blob/master/ghdocs/Testing/BrowserSupport.md) for more information.
+Fabric React supports many commonly used browsers. See the [browser support doc](./ghdocs/Testing/BrowserSupport.md) for more information.
 
 ## Server-side rendering
 
@@ -125,7 +125,7 @@ In Jest:
 
 ## Advanced usage
 
-For advanced usage including info about module vs. path-based imports, using an AMD bundler like Require, and deployment features, see our [advanced documentation](https://github.com/OfficeDev/office-ui-fabric-react/blob/master/ghdocs/BestPracties/ADVANCED.md).
+For advanced usage including info about module vs. path-based imports, using an AMD bundler like Require, and deployment features, see our [advanced documentation](./ghdocs/BestPractices/Advanced.md).
 
 ## Contribute to Office UI Fabric React
 
diff --git a/ghdocs/Contributing/BugFixes.md b/ghdocs/Contributing/BugFixes.md
index 17e14279d3f06..b657ab6ca488a 100644
--- a/ghdocs/Contributing/BugFixes.md
+++ b/ghdocs/Contributing/BugFixes.md
@@ -3,7 +3,7 @@
 
  Please use the following steps to contribute bug fixes
 
-* Setup your branch using instructions in [GitbranchSetup](./GitBranchSetup.md)
+* Setup your branch using instructions in [GitbranchSetup](./Setup.md)
 
 * Code and test the bug fix.
 

From 7c519e0beef5a8172e710dd51620279144281a58 Mon Sep 17 00:00:00 2001
From: Manish Garg <manishga@microsft.com>
Date: Mon, 9 Apr 2018 15:33:57 -0700
Subject: [PATCH 06/10] Minor cleanup

---
 ghdocs/BestPractices/Theming.md     | 2 +-
 ghdocs/Contributing/Contributing.md | 2 +-
 ghdocs/Contributing/Setup.md        | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/ghdocs/BestPractices/Theming.md b/ghdocs/BestPractices/Theming.md
index fc082b73d0201..c24e92778dc55 100644
--- a/ghdocs/BestPractices/Theming.md
+++ b/ghdocs/BestPractices/Theming.md
@@ -66,7 +66,7 @@ All styles must also be registered through this module instead of being put dire
 See the documentation for more details on implementation.
 
 ### `styling` package
-The new and recommended way is the [styling package](https://github.com/OfficeDev/office-ui-fabric-react/tree/master/packages/styling) in this repo.
+The new and recommended way is the [styling package](./Styling.md) in this repo.
 Styles are defined in a JSON format and managed in code, avoiding issues like specificity and providing a typesafe surface for customization.
 The theme itself gets passed to the component. As the theme changes, the state of the component changes as well, and it will modify its own CSS to match.
 
diff --git a/ghdocs/Contributing/Contributing.md b/ghdocs/Contributing/Contributing.md
index 5df99d76fc624..8e6f1cafbbf39 100644
--- a/ghdocs/Contributing/Contributing.md
+++ b/ghdocs/Contributing/Contributing.md
@@ -1,5 +1,5 @@
 
- ## Contributing to Office UI Fabric
+ ## Contributing to Office UI Fabric React
 
 Please use the following steps to contribute a new component or a bug fix to the Office UI Fabric project.
 
diff --git a/ghdocs/Contributing/Setup.md b/ghdocs/Contributing/Setup.md
index 0afd74beaf793..2c3fdd6a9e73c 100644
--- a/ghdocs/Contributing/Setup.md
+++ b/ghdocs/Contributing/Setup.md
@@ -1,4 +1,4 @@
-# [office-ui-fabric-react](../../../README.md) › Contributing
+# Git branch setup
 
 This document describes how to setup your development environment and contribute changes to the **office-ui-fabric-react** project. This document assumes basic working knowledge with Git and related tools. We are providing instructions specific to this project.
 

From 91d57c5545aa390965fb845b9fa8d5c579d132c2 Mon Sep 17 00:00:00 2001
From: Manish Garg <manishga@microsft.com>
Date: Tue, 10 Apr 2018 09:35:23 -0700
Subject: [PATCH 07/10] more code review comments

---
 FAQ.md                          | 30 ++++++++++++++++++++++++++----
 ghdocs/BestPractices/Testing.md |  2 +-
 2 files changed, 27 insertions(+), 5 deletions(-)

diff --git a/FAQ.md b/FAQ.md
index 82e26aac5f1e3..9634593d29d6e 100644
--- a/FAQ.md
+++ b/FAQ.md
@@ -6,9 +6,9 @@ Fabric React is a responsive, mobile-first, open-source collection of robust com
 
 ## *Q. Who uses Office UI Fabric React?*
 
-React components from Office UI Fabric React are used by many teams accross O365 and Microsoft for building their experiences. Some examples are Sharepoint, OneDrive, Outlook, VisualStudio Online, ...
+React components from Office UI Fabric React are used by many teams accross O365 and Microsoft for building their experiences. Some examples are SharePoint, OneDrive, Outlook, VisualStudio team services, ...
 
-These components are also used by third party developers buiding extensiblity components using the SharePoint Framework.
+These components are also used by third party developers building extensiblity components using the SharePoint Framework.
 
 ## *Q. How do I get started with Office UI Fabric React?*
 
@@ -16,15 +16,17 @@ Start with our [README](./README.md) document.
 
 ## *Q. Where is the official website located?*
 
+https://developer.microsoft.com/fabric
 http://dev.office.com/fabric
 
+
 ## *Q. Can I contribute to Office UI Fabric React?*
 
 Office UI Fabric React is an open-source distributed project. Lots of developers from inside and outside Microsoft contribute to this project. We highly encourage contributions. There is a core team that works hard to stay on top of the issues and pull requests.
 
 ## *Q. Why should I contribute?*
 
-Office UI Fabric React is an open-source distributed project. If you are building a new app inside O365 or Microsoft, this project will potentially save you lots of time, resources and headaches. We encourage all developers who use Fabric React to return a small amount to the community. If you notice bugs, we encourage you to not only open an issue on it but also help fix it. If you have a component that you believe others should use, feel motivated and encouraged to contribute that component back to the community. Sharing is caring. Many developers contribute outside their primary job responsibilities. Additionally, there is plenty to learn. We use a lot of best practices used in the industry. Learning those can  help you in your career.
+Office UI Fabric React is an open-source distributed project. If you are building a new app inside O365 or Microsoft, this project will potentially save you lots of time, resources and headaches. We encourage all developers who use Fabric React to return a small amount to the community. If you notice bugs, we encourage you to not only open an issue on it but also help fix it. If you have a component that you believe others should use, feel motivated and encouraged to contribute that component back to the community. Sharing is caring. Many developers contribute outside their primary job responsibilities. Additionally, there is plenty to learn. We use a lot of cutting edge best practices used in the industry. Learning those can help you in your career.
 
 ## *Q. How do I communicate with a Fabric React core team member?*
 
@@ -40,4 +42,24 @@ Yes, you totally can. You will need to help out with reviewing pull requests and
 
 ## *Q. My pull request has been hanging for a long time. What do I do?*
 
-We are very proactive and work hard to keep the outstanding pull request count low. But if your pull request is non-trivial and stuck for a long time, please feel free to tag the pull request that it has been hanging for long and you need help.
\ No newline at end of file
+We are very proactive and work hard to keep the outstanding pull request count low. But if your pull request is non-trivial and stuck for a long time, please feel free to tag the pull request that it has been hanging for long and you need help.
+
+## *Q. Where do I read about specific best practices?*
+
+Please refer to the following documents.
+
+[**Contributing fixes and new components**](./ghdocs/Contributing/Contributing.md)
+
+[**Accessibility**](./ghdocs/BestPractices/Accessibility.md)
+
+[**Component Design**](./ghdocs/BestPractices/ComponentDesign.md)
+
+[**Styling**](./ghdocs/BestPractices/Styling.md)
+
+[**Theming**](./ghdocs/BestPractices/Theming.md)
+
+[**Testing**](./ghdocs/BestPractices/Testing.md)
+
+[**Advanced**](./ghdocs/BestPractices/Advanced.md)
+
+[**Browse Support**](./ghdocs/Testing/BrowserSupport.md)
\ No newline at end of file
diff --git a/ghdocs/BestPractices/Testing.md b/ghdocs/BestPractices/Testing.md
index f042d80be30d0..5349348f73704 100644
--- a/ghdocs/BestPractices/Testing.md
+++ b/ghdocs/BestPractices/Testing.md
@@ -4,7 +4,7 @@
 
 Our tests are built using [Jest](https://facebook.github.io/jest/). This allows us to run tests in a node environment, and simulates the browser using jsdom.
 
-For snapshot testing, we use `react-test-renderer` and `Jest apis`.
+For snapshot testing, we use `react-test-renderer` and `Jest APIs`.
 
 For creating React functional tests, we use [Enzyme](http://airbnb.io/enzyme/) to automate rendering. This gives us helpers for mounting a component, accessing elements rendered by it, and simulating clicks and keypresses.
 

From ec6f708cf63928661e47ac1d888d64bb7a00ce3a Mon Sep 17 00:00:00 2001
From: Manish Garg <manishga@microsft.com>
Date: Tue, 10 Apr 2018 11:53:09 -0700
Subject: [PATCH 08/10] SampleApp document

---
 FAQ.md                              |  67 +++++++++++-
 ghdocs/Contributing/ChangeFiles.md  |   6 +-
 ghdocs/Contributing/NewComponent.md |  17 ----
 ghdocs/OnBoarding/SampleApp.md      | 152 ++++++++++++++++++++++++++++
 4 files changed, 221 insertions(+), 21 deletions(-)
 create mode 100644 ghdocs/OnBoarding/SampleApp.md

diff --git a/FAQ.md b/FAQ.md
index 9634593d29d6e..e09104579def8 100644
--- a/FAQ.md
+++ b/FAQ.md
@@ -14,11 +14,60 @@ These components are also used by third party developers building extensiblity c
 
 Start with our [README](./README.md) document.
 
+To create your first app using Office UI Fabric React read the [Sample App](./OnBoarding/SampleApp.md) document.
+
 ## *Q. Where is the official website located?*
 
 https://developer.microsoft.com/fabric
+
 http://dev.office.com/fabric
 
+## *Q. I am seeing a bug. Where can I open an issue?*
+
+Please open all issues at our [GitHub issues](https://github.com/OfficeDev/office-ui-fabric-react/issues) location.
+
+Things to remember while opening an issue
+
+* Please fill out as many details as you can.
+* We **highly encourage** you to submit PRs for issues.
+
+
+
+```
+  ----------------------------------------------------------------------------------------------
+
+  ### Bug Report
+
+  - __Package version(s)__: (fill this out)
+  - __Browser and OS versions__: (fill this out if relevant)
+
+  #### Priorities and help requested (not applicable if asking question):
+
+  Are you willing to submit a PR to fix? (Yes, No)
+
+  Requested priority: (Blocking, High, Normal, Low)
+
+  Products/sites affected: (if applicable)
+
+  #### Describe the issue:
+
+  <!-- fill this out -->
+
+  #### Actual behavior:
+
+  <!-- fill this out -->
+
+  #### Expected behavior:
+
+  <!-- fill this out -->
+
+  ### If applicable, please provide a codepen repro:
+
+  <!-- See http://codepen.io/dzearing/pens/public/?grid_type=list for a variety of examples -->
+
+  ----------------------------------------------------------------------------------------------
+```
+
 
 ## *Q. Can I contribute to Office UI Fabric React?*
 
@@ -62,4 +111,20 @@ Please refer to the following documents.
 
 [**Advanced**](./ghdocs/BestPractices/Advanced.md)
 
-[**Browse Support**](./ghdocs/Testing/BrowserSupport.md)
\ No newline at end of file
+[**Browse Support**](./ghdocs/Testing/BrowserSupport.md)
+
+## *Q. When and how does the issue Triage work?*
+
+The Fabric React core team works hard to stay on top of the open issues. We triage issues at least once a week. Due to an increased volume in the number of issues, we have been triaging more often. Once the issue count is under control, we may go back to the once a week rythm.
+
+### Following issues will qualify as high priority
+
+We try to fix high priority bugs ASAP.
+
+* Is this issue blocking the consumer?
+* Is this a regression? If yes, how and when did it get in?
+* Is this a very serious bug?
+
+Other bugs will qualify as Normal or lower priority and will get fixed as a part of the normal release cadence.
+
+From time to time we do plan to close issues that are very old and have no activity.
\ No newline at end of file
diff --git a/ghdocs/Contributing/ChangeFiles.md b/ghdocs/Contributing/ChangeFiles.md
index 7baf396ec102a..887a1d8b60841 100644
--- a/ghdocs/Contributing/ChangeFiles.md
+++ b/ghdocs/Contributing/ChangeFiles.md
@@ -23,12 +23,12 @@ Following changes should require a **minor** build number change
 
 - When you add new functionality that is backward compatible.
 
+- A new component should qualify as a **minor** change because it is fully backward compatible. In case, you made breaking changes to other generic APIs that are used by developers and can break them.
+
 ### Major
 
 Any changes that are not backward compatible should be qualified as **major** changes.
 
 - Any breaking API changes. i.e. API deletions, mandatory new APIs, API renames.
 
-- Addition or removal of functionality in a non backward compatible way.
-
-- A new component should qualify as a **major** change.
\ No newline at end of file
+- Addition or removal of functionality in a non backward compatible way.
\ No newline at end of file
diff --git a/ghdocs/Contributing/NewComponent.md b/ghdocs/Contributing/NewComponent.md
index 3bb0fb09ccd0a..0902671a9572d 100644
--- a/ghdocs/Contributing/NewComponent.md
+++ b/ghdocs/Contributing/NewComponent.md
@@ -70,7 +70,6 @@ Fundamental components are the official React representation of our [Adobe XD To
   * In this example the component will be called `ExcitingNewComponent`.
 3. Create a `ExcitingNewComponent.types.ts` file that will contain an interface for your component props
 
-  * @todo: review
   * Import React
     * `import * as React from 'react'`;
   * Import ExcitingNewComponent
@@ -82,22 +81,6 @@ Fundamental components are the official React representation of our [Adobe XD To
     * `export interface IExcitingNewComponentProps extends React.Props<ExcitingNewComponent> { … Props }`
   * Create and export an interface for ExcitingNewComponent styles.
 
-```ts
-import * as React from 'react';
-import { ExcitingNewComponent } from './ExcitingNewComponent';
-import { IStyle } from '../../Styling';
-
-export interface IExcitingNewComponent {
-}
-
-export interface IExcitingNewComponentProps extends React.Props<ExcitingNewComponent> {
-  /**
-  * All props for your component are to be defined here.
-  */
-  componentRef?: (component: IExcitingNewComponent) => void;
-}
-```
-
 4. Create a react file, `ExcitingNewComponent.tsx`.
 
 ```ts
diff --git a/ghdocs/OnBoarding/SampleApp.md b/ghdocs/OnBoarding/SampleApp.md
new file mode 100644
index 0000000000000..155f7b10b2df1
--- /dev/null
+++ b/ghdocs/OnBoarding/SampleApp.md
@@ -0,0 +1,152 @@
+## Overview
+In this tutorial, let's build a simple React app with an Office UI Fabric React DocumentCard.
+
+## Prerequisites
+### Setup
+For this exercise, you don't need to go through all the steps in the [Setup](../Contributing/Setup.md) document.
+
+Just these steps are enough
+
+- Install **Node.js LTS 8** or greater from thes **[Node.js website](https://nodejs.org/en/)**.
+- Install **[Git](https://git-scm.com/)**.
+- For code editing we like **[Visual Studio Code ](https://code.visualstudio.com/)**
+
+### create-react-app package
+We will use [Create React App](https://facebook.github.io/react/blog/2016/07/22/create-apps-with-no-configuration.html) to quickly create a React app for this tutorial.
+
+Once node and npm is installed, type the following command in a console to install the `create-React-app` npm package.
+
+```
+npm install -g create-react-app
+```
+
+## Step 1: Create react app
+In a console, type the following command to create a simple React app.
+
+```
+create-react-app documentcardbasic-demo
+```
+
+This will install the required depedencies and scaffold a simple React app.
+
+![create-react-app command completed](../images/create-react-app-created.png)
+
+Once its complete, navigate to the `documentcardbasic-demo` folder.
+
+```
+cd documentcardbasic-demo
+```
+
+Type the following command to launch the React app in your browser.
+
+```
+npm start
+```
+
+![create-react-app preview in browser](../images/create-react-app-preview.png)
+
+## Step 2: Install office-ui-fabric-react package
+To use Fabric React in your project, you will need to first install the `office-ui-fabric-react` npm package. Type the following in the console to install the package:
+
+```
+npm install office-ui-fabric-react --save
+```
+
+>If you have `npm start` command still running, terminate the command by pressing `Ctrl+C`.
+
+## Step 3: Add DocumentCardBasic component
+Open the `documentcardbasic-demo` project folder in Visual Studio Code.
+
+Open the file `src\App.js` and replace the existing code inside `render` method to only return the `DocumentCard` component:
+
+```jsx
+<div>
+  <DocumentCard onClickHref='http://bing.com'>
+      <DocumentCardPreview
+        previewImages={ [
+          {
+            previewImageSrc: require('./documentpreview.png'),
+            iconSrc: require('./iconppt.png'),
+            width: 318,
+            height: 196,
+            accentColor: '#ce4b1f'
+          }
+        ] }
+      />
+      <DocumentCardTitle title='Revenue stream proposal fiscal year 2016 version02.pptx'/>
+      <DocumentCardActivity
+        activity='Created Feb 23, 2016'
+        people={
+          [
+            { name: 'Kat Larrson', profileImageSrc: require('./avatarkat.png') }
+          ]
+        }
+        />
+    </DocumentCard>
+</div>
+```
+`DocumentCard` component contains the `DocumentCardPreview`, `DocumentCardTitle` and `DocumentCardActivity` components that help you describe the document card.
+
+Since `office-ui-fabric-react` is a npm module, we will need to import the document card component in the `App` component.
+
+Add the following import statement at the top of the `src\App.js` file just below `import './App.css'`:
+
+```js
+import {
+  DocumentCard,
+  DocumentCardPreview,
+  DocumentCardTitle,
+  DocumentCardActivity
+} from 'office-ui-fabric-react/lib/DocumentCard';
+```
+
+Notice how we import only the specific component module from `lib` folder instead of importing the entire `office-ui-fabric-react` module.
+
+Save the `src\App.js` file.
+
+Below is an example of how you can similarly import other components:
+
+```js
+import { Button } from 'office-ui-fabric-react/lib/Button';
+```
+
+Open `index.html` file.
+
+Fabric React components provide support for Left-to-Right (LTR) and Right-to-Left (RTL) rendering out of the box.
+
+You can specify the default direction in your `index.html`. Add the `dir` attribute with the value `ltr` to the `<html>` element:
+
+```html
+<html lang="en" dir="ltr">
+```
+
+Load Office UI Fabric styles by linking to the Office UI Fabric CDN. Add the following to the `<head`> element:
+
+```html
+<link rel="stylesheet" href="https://static2.sharepointonline.com/files/fabric/office-ui-fabric-core/9.2.0/css/fabric.min.css">
+```
+
+Save the file.
+
+Copy the following images from GitHub to `src` folder.
+* [avatarkat.png](../images/avatarkat.png)
+* [iconppt.png](../images/iconppt.png)
+* [documentpreview.png](../images/documentpreview.png)
+
+## Step 4: Preview document card
+Switch to the console and type the following to preview your app in the browser:
+
+```
+npm start
+```
+
+You should see the document card component in your app.
+
+![DocumentCard preview](../images/react-app-doccard-preview.png)
+
+## Next steps
+Congratulations! You have successfully built a simple React app with an Office UI Fabric React DocumentCard.
+
+As next steps, try using other components like `DetailsLists`, `Callout` etc.,
+
+

From 8c41829d2875ee8ecfc2155fcd8149d0e97734cc Mon Sep 17 00:00:00 2001
From: Manish Garg <manishga@microsft.com>
Date: Tue, 10 Apr 2018 11:54:59 -0700
Subject: [PATCH 09/10] Fixed SampleApp link

---
 FAQ.md | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/FAQ.md b/FAQ.md
index e09104579def8..9a04bf1aca4a8 100644
--- a/FAQ.md
+++ b/FAQ.md
@@ -14,7 +14,7 @@ These components are also used by third party developers building extensiblity c
 
 Start with our [README](./README.md) document.
 
-To create your first app using Office UI Fabric React read the [Sample App](./OnBoarding/SampleApp.md) document.
+To create your first app using Office UI Fabric React read the [Sample App](./ghdocs/OnBoarding/SampleApp.md) document.
 
 ## *Q. Where is the official website located?*
 
@@ -122,8 +122,7 @@ The Fabric React core team works hard to stay on top of the open issues. We tria
 We try to fix high priority bugs ASAP.
 
 * Is this issue blocking the consumer?
-* Is this a regression? If yes, how and when did it get in?
-* Is this a very serious bug?
+* Is this a regression? If yes, how and when did it get in?* Is this a very serious bug?
 
 Other bugs will qualify as Normal or lower priority and will get fixed as a part of the normal release cadence.
 

From 3b3d9c2ee9a2c987f046228c62b6248b1c7bbb1b Mon Sep 17 00:00:00 2001
From: Manish Garg <manishga@microsft.com>
Date: Tue, 10 Apr 2018 12:02:33 -0700
Subject: [PATCH 10/10] Some final cleanup

---
 README.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/README.md b/README.md
index 8c5bc64cb385c..c580642e56131 100644
--- a/README.md
+++ b/README.md
@@ -48,11 +48,14 @@ ReactDOM.render(
   document.body.firstChild
 );
 ```
+**[⬆ back to top](#Contents)**
 
 ## Browser support
 
 Fabric React supports many commonly used browsers. See the [browser support doc](./ghdocs/Testing/BrowserSupport.md) for more information.
 
+**[⬆ back to top](#Contents)**
+
 ## Server-side rendering
 
 If you need to render Fabric components on the server side in a node environment, there is a way to do this. The basic idea is that you need to tell the styles loader to pipe styles into a variable, which you can later use to inject into your page. Example:
@@ -89,6 +92,8 @@ console.log(
 
 Note: we are evaluating a more robust theming and style loading approach, which will allow a much more flexible server rendering approach, so this syntax may be simplified in the future.
 
+**[⬆ back to top](#Contents)**
+
 ### Browserless Testing
 
 In unit or end-to-end tests that run in an SSR-like (non-browser) environment such as Node, you'll need to disable style loading.
@@ -123,14 +128,20 @@ In Jest:
   }
 ```
 
+**[⬆ back to top](#Contents)**
+
 ## Advanced usage
 
 For advanced usage including info about module vs. path-based imports, using an AMD bundler like Require, and deployment features, see our [advanced documentation](./ghdocs/BestPractices/Advanced.md).
 
+**[⬆ back to top](#Contents)**
+
 ## Contribute to Office UI Fabric React
 
 Please take a look at our [contribution guidelines](./ghdocs/Contributing/Contributing.md) for more info. Also read [Contribute Bug fixes](./ghdocs/Contributing/BugFixes.md) and [Contribute New component](./ghdocs/Contributing/NewComponent.md).
 
+**[⬆ back to top](#Contents)**
+
 ## Building the repo
 
 Before you get started, **make sure you have read the [Git branch setup instrucions](./ghdocs/Contributing/Setup.md)**
@@ -147,10 +158,14 @@ To build and run tests for all packages in the repo, you can run `npm run build`
 
 To build individual packages within the `packages/*/` folders, you can use `npm run build` in each individually. Note that because the packages are symlinked together, you must manage building dependencies in the right order, or use the `rush` tool to build to the specific package you want. (See advanced tips below.)
 
+**[⬆ back to top](#Contents)**
+
 ## Testing
 
 For testing see our [testing documentation](./ghdocs/BestPractices/Testing.md).
 
+**[⬆ back to top](#Contents)**
+
 ## Advanced building tips
 
 The repo contains many packages, each which may have dependencies on each other. You can use the rush tool to build projects in the correct order, if you have it globally installed.
@@ -167,12 +182,15 @@ To can also build up to a specific project using the `--to <package>` argument.
 rush build --to office-ui-fabric-react
 ```
 
+**[⬆ back to top](#Contents)**
+
 ## Licenses
 
 All files on the Office UI Fabric React GitHub repository are subject to the MIT license. Please read the License file at the root of the project.
 
 Usage of the fonts and icons referenced in Office UI Fabric is subject to the terms of the [assets license agreement](http://aka.ms/fabric-assets-license).
 
+**[⬆ back to top](#Contents)**
 
 ## Changelog
 
@@ -181,3 +199,5 @@ We use [GitHub Releases](https://github.com/blog/1547-release-your-software) to
 - - -
 
 This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
+
+**[⬆ back to top](#Contents)**