docs: update documentation for contributions, code of conduct, and pa… (

microsoft#19)

* docs: update documentation for contributions, code of conduct, and packages

* updated conventional changelog details per feedback from team

.github/pull_request_template.md

@@ -1,25 +1,7 @@
-### Commit/Merge messages
-Commit messages should be in the following format: 
-> `type(category): [description] [issue number].`
+## Detail
 
-Must be one of the following **types**:
-- `a11y`
-- `chore`
-- `docs`
-- `feat`
-- `fix`
-- `other`
-- `refactor`
-- `style`
-- `test`
 
-**Category:** This should be an area or feature name. For example, c-button.
+## Attributes
 
-**Description:** A single line, lowercase, ending with a '.', and without naming any component this relates to. Components can be referred to by the *Tag(s)*.
 
-**Issue number:** Maps directly to the GitHub issue number. Can be more than one if the work is related.
-
-**Labels:** Specific changes mapping to how work is managed across the project.
-
-Example:
->`docs(readme): add an accessibility section to the readme [123456]`
+For [details on formatting](https://fluentweb.com/prototyping/contribution-policy) the title, details, and attributes.

CONTRIBUTING.md

@@ -1,60 +1,6 @@
-# Contributing
-This project welcomes contributions and suggestions.  Most contributions require you to agree to a
-Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
-the rights to use your contribution. For details, visit https://cla.microsoft.com.
+# Contribution policy
+A “Contribution” is any work that is voluntarily submitted to a project. This work may be code, documentation, design, answering questions, or even triaging issues.
 
-When you submit a pull request, a CLA-bot will automatically determine whether you need to provide
-a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions
-provided by the bot. You will only need to do this once across all repos using our CLA.
+Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.
 
-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.
-
-## Getting started
-First, clone the repository and `cd` into the project.
-
-Install [lerna](https://github.com/lerna/lerna):
-```shell
-npm install --global lerna
-```
-
-
-Bootstrap lerna to install all dependencies:
-```shell
-lerna bootstrap
-```
-
-## Commit message format
-FAST-design follows [conventional commits](https://conventionalcommits.org/) for commit messages. Additional types are heavily inspired by Angular's [commit message format](https://github.com/angular/angular/blob/master/CONTRIBUTING.md#commit).
-
-Per conventional commits 1.0.0, a commit message should be structured as follows:
-```
-<type>[optional scope]: <description>
-
-[optional body]
-
-[optional footer]
-```
-
-### Types
-The following types are supported:
-- **build**: Changes that affect the build system
-- **docs**: Documentation only changes
-- **feat**: Adding a new feature
-- **fix**: Fixing an issue / bug
-- **perf**: Performance related changes
-- **refactor**: Refactoring existing features
-- **test**: Changes specific to tests
-
-### Description
-Commit message descriptions should be concise and must conform to the following:
-- use the imperative, present tense. (fix - not fixes)
-- single sentence without sentence casing (fix - not Fix)
-- no period at the end
-
-### Body
-The body is optional. It should be used to provide clarity and context to the description.
-
-### Footer
-The footer should provide additional metadata about the pull request such as issue fixing (fixes #19).
+When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

README.md

@@ -1 +1,82 @@
 # FAST-DNA
+Fast, adaptive, secure, and timeless design network architecture.
+
+## Policies
+### Contributions
+Details including getting start can be found [here](https://github.com/Microsoft/fast-dna/blob/master/CONTRIBUTING.md).
+
+### Code of conduct
+Details are located [here](https://github.com/Microsoft/fast-dna/blob/master/CODE_OF_CONDUCT.md).
+
+### Guiding principles and governance
+Details around process, expectations, and quality [visit](https://fluentweb.com/prototyping/contribution-policy).
+
+## Getting started
+First, clone the repository and `cd` into the project.
+
+Install [lerna](https://github.com/lerna/lerna):
+```shell
+npm install --global lerna
+```
+
+Bootstrap lerna to install all dependencies:
+```shell
+lerna bootstrap
+```
+
+## Commit and merge messages
+FAST-DNA takes inspiration from [conventional commits](https://conventionalcommits.org/) and has been modified to meet requirements.
+
+**Accepted title format**: "`<type>(<scope>): <description>`"
+
+Optionally, include more detail in the message with a single blank line between formatted as:
+```
+<body>
+
+<footer>
+```
+
+### Types
+The following types are supported:
+- **build**: Changes that affect the build system or external dependencies
+- **docs**: Documentation changes
+- **feat**: Adding or changing a feature
+- **fix**: Fixing an issue / bug
+- **refactor**: Architectural changes that do not address a bug or feature
+- **test**: Adding or changing test infrastructure
+
+### Scopes
+Optionally used when changes impact an area, feature, or package. 
+- Use component name (e.g.: button, hyperlink)
+- Use pattern name (e.g.: banner, additional-information)
+- Use package name (e.g.: fast-development-site)
+
+### Description
+Describe what feature or fix the user gets from this PR.
+- Use single line
+- Use lowercase
+- Use imperative, present tense (e.g.: fix, not fixes)
+- Use single sentence without sentence casing and no period at the end
+
+### Body
+Optional `<body>` used to provide clarity and context to the description.
+
+### Footer
+Optional `<footer>` used to provide additional metadata about the pull request such as issue fixing (fix #19, close #19, resolve #19).
+
+### Pull request commenting
+Add a comment with the issue number per the [github closing issue keywords](https://help.github.com/articles/closing-issues-using-keywords/).
+
+Example title
+```
+feat(button): add a border radius to button
+```
+
+Example message detail
+```
+Sequence indicators markup was moved from being located after the slider markup to at the top for improved accessibility because the screen reader can read all of the slide options individually before interacting with the slider.
+
+fix 915,920
+close 213
+resolve 429
+```

package.json

@@ -1,19 +1,22 @@
 {
   "name": "@microsoft/fast-dna",
-  "private": true,
-  "license": "MIT",
-  "scripts": {
-    "tslint": "tslint -c ./tslint.json \"**/*.ts\" \"**/*.tsx\"",
-    "tslint:fix": "tslint -c ./tslint.json --fix \"**/*.ts\" \"**/*.tsx\""
-  },
+  "description": "Fast, adaptive, secure, and timeless design network architecture.",
   "author": {
     "name": "Fluent Web",
     "email": "fwq@microsoft.com"
   },
+  "version": "1.0.0",
+  "private": true,
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Microsoft/fast-dna.git"
   },
+  "license": "MIT",
+  "readme": "README.md",
+  "scripts": {
+    "tslint": "tslint -c ./tslint.json \"**/*.ts\" \"**/*.tsx\"",
+    "tslint:fix": "tslint -c ./tslint.json --fix \"**/*.ts\" \"**/*.tsx\""
+  },
   "devDependencies": {
     "@microsoft/fast-tslint-rules": "^1.0.4",
     "lerna": "^2.9.0",

packages/fast-development-site/package.json

@@ -1,13 +1,21 @@
 {
-  "name": "fast-development-site",
+  "name": "@microsoft/fast-development-site",
+  "description": "FAST development testing site.",
+  "author": {
+    "name": "Fluent Web",
+    "email": "fwq@microsoft.com"
+  },
   "version": "1.0.0",
-  "description": "",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Microsoft/fast-dna.git"
+  },
   "main": "index.js",
   "scripts": {
     "dev-server": "webpack-dev-server --progress"
   },
-  "author": "",
-  "license": "ISC",
+  "license": "MIT",
+  "readme": "README.md",
   "dependencies": {
     "@microsoft/fast-react-components-base": "^0.0.0",
     "@microsoft/fast-react-components-fluent": "^0.0.0",

packages/fast-react-components-base/package.json

@@ -1,13 +1,17 @@
 {
   "name": "@microsoft/fast-react-components-base",
-  "version": "0.0.0",
-  "description": "FAST base components implemented in React",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "description": "FAST base components implemented in React.",
+  "author": {
+    "name": "Fluent Web",
+    "email": "fwq@microsoft.com"
+  },
+  "version": "1.0.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Microsoft/fast-dna.git"
   },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "scripts": {
     "build": "npm run clean:dist && tsc -p ./tsconfig.json",
     "clean:dist": "node ./build/clean.js dist",
@@ -16,12 +20,9 @@
     "tslint": "tslint -c ../../tslint.json \"**/*.ts\" \"**/*.tsx\"",
     "tslint:fix": "tslint -c ../../tslint.json --fix \"**/*.ts\" \"**/*.tsx\"",
     "prepare": "npm run build"
-  },
-  "author": {
-    "name": "Fluent Web",
-    "email": "fwq@microsoft.com"
-  },
+  }, 
   "license": "MIT",
+  "readme": "README.md",
   "jest": {
     "testPathIgnorePatterns": [
       "/node_modules/",

packages/fast-react-components-fluent/package.json

@@ -1,13 +1,17 @@
 {
   "name": "@microsoft/fast-react-components-fluent",
-  "version": "0.0.0",
   "description": "FAST Fluent components implemented in React",
-  "main": "dist/index.js",
-  "type": "dist/index.d.ts",
+  "author": {
+    "name": "Fluent Web",
+    "email": "fwq@microsoft.com"
+  },
+  "version": "1.0.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Microsoft/fast-dna.git"
   },
+  "main": "dist/index.js",
+  "type": "dist/index.d.ts",
   "scripts": {
     "build": "npm run clean:dist && tsc -p ./tsconfig.json",
     "clean:dist": "node ./build/clean.js dist",
@@ -17,11 +21,8 @@
     "tslint:fix": "tslint -c ../../tslint.json --fix \"**/*.ts\" \"**/*.tsx\"",
     "prepare": "npm run build"
   },
-  "author": {
-    "name": "Fluent Web",
-    "email": "fwq@microsoft.com"
-  },
   "license": "MIT",
+  "readme": "README.md",
   "jest": {
     "testPathIgnorePatterns": [
       "/node_modules/",