Add github pages publishing script

.gitignore

@@ -11,4 +11,7 @@ public
 # Test reports
 coverage
 
+# Built storybook
+storybook_dist
+
 packages/**/dist

CONTRIBUTING.md

@@ -95,3 +95,11 @@ The `README.md` should cover the following territory:
 ```
 
 In addition, the `README.md` should also point to Psammead's [CODE_OF_CONDUCT](https://github.com/BBC-News/psammead/blob/latest/CODE_OF_CONDUCT.md), [CONTRIBUTING](https://github.com/BBC-News/psammead/blob/latest/CONTRIBUTING.md) guide, and [LICENSE](https://github.com/BBC-News/psammead/blob/latest/LICENSE).
+
+### After merge
+
+After merging a pull request into `latest`, please follow these steps to ensure that the changes are published to npm and to the Psammead Storybook https://bbc-news.github.io/psammead.
+- Publish Packages  
+  To make your changes available on the npm registry please publish any package changes. The instructions to do this can be found in the the [repository README](https://github.com/BBC-News/psammead#rocket-publishing-packages) 
+- Publish Storybook  
+  When changes are made to a component its important to ensure the changes are visible on the hosted storybook. To do this please follow the instructions on the [repository README](https://github.com/BBC-News/psammead#deploying-storybook)

README.md

@@ -3,7 +3,7 @@
 <div align="center">
 
 [![Known Vulnerabilities](https://snyk.io/test/github/bbc-news/psammead/badge.svg)](https://snyk.io/test/github/bbc-news/psammead)
-[![Storybook](https://github.com/storybooks/press/blob/master/badges/storybook.svg)](http://bbc-news.github.io/psammead)
+[![Storybook](https://github.com/storybooks/press/blob/master/badges/storybook.svg)](https://bbc-news.github.io/psammead)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/BBC-News/psammead/blob/latest/CONTRIBUTING.md)
 
 </div>
@@ -139,3 +139,13 @@ _We will be moving this process to CI in future. This is a temporary solution._
 ### :tada: Making a package public
 
 - `npm access public @bbc/<PACKAGE_NAME> --otp=<YOUR_2FA_CODE>`
+
+### :roller_coaster: Deploying Storybook
+
+The Psammead Storybook is hosted on GitHub pages at http://bbc-news.github.io/psammead. It is currently deployed via a local script that builds Storybook to the `gh-pages` git branch which is used by GitHub pages.
+
+```
+npm run deploy-storybook
+```
+
+NB, this automatically pushes to the 'gh-pages' branch, which deploys to the live GitHub pages site. Please only run this script on the `latest` branch.