feat: contribute 'Workbench Application Platform' to allow integratin…

…g content from multiple web applications

SCION Workbench Application Platform is an extension of SCION Workbench to integrate content from multiple web applications in a coherent way, thus enabling a micro frontend architecture for allowing different front-end frameworks to co-exist and independent delivery.

The platform provides the mechanics for client-side web application integration. Any web application can be integrated. If the site does not interact with the platform, there is no need for adaptation. For a deeper integration, the platform provides a framework-agnostic guest API.

closes #80

CONTRIBUTING.md

@@ -1,8 +1,7 @@
 ![SCION Workbench](/resources/site/logo/scion-workbench-banner.png)
 
-[Overview][menu-overview] | [Demo][menu-demo] | [Getting Started][menu-getting-started] | [How To][menu-how-to] | [Contributing][menu-contributing] | [Changelog][menu-changelog] | [Sponsoring][menu-sponsoring] | [Links][menu-links]
-|---|---|---|---|---|---|---|---|
-
+[Overview][menu-overview] | [Workbench][menu-workbench] | [Workbench Application Platform][menu-workbench-application-platform] | [Contributing][menu-contributing] | [Changelog][menu-changelog] | [Sponsoring][menu-sponsoring] | [Links][menu-links]
+|---|---|---|---|---|---|---|
 
 # Contributing
 
@@ -35,11 +34,36 @@ Please follow the guidelines below:
 
 > Please be in mind that large pull requests take a lot of time to review.
 
-## Build SCION Workbench
-The project is built with Travis CI and is automatically built, its tests executed and linted as you push it to GitHub.
+## Build SCION Workbench and SCION Workbench Application Platform
+The project is built with [Travis CI][link-travis-ci]. When pushing to GitHub, the project is built, its tests executed and linted. When merging a PR to the master branch, the demo application is deployed to https://scion-workbench-application-platform.now.sh. When a release tag is added to the master branch, SCION modules are deployed to NPM.
 
 [![Build Status](https://travis-ci.com/SchweizerischeBundesbahnen/scion-workbench.svg?token=sT5ouhFsqwt9RmkLsQb8&branch=master)](https://travis-ci.com/SchweizerischeBundesbahnen/scion-workbench)
 
+### Local development
+For local development, you can uncomment the section `PATH-OVERRIDE-FOR-LOCAL-DEVELOPMENT` in `tsconfig.json`. This allows running tests or serving the demo application without having to build dependent modules first.
+
+Use following commands to build, lint and test the project.
+
+```
+npm run build
+npm run lint
+npm run test
+```
+
+You can serve the demo/test application as follows (SCION Workbench Application Platform):
+```
+npm run app:workbench-application-platform:serve ➀
+```
+
+You can run e2e-tests as follows (SCION Workbench Application Platform):
+```
+npm run app:workbench-application-platform:e2e ➀
+```
+
+|#|Explanation|
+|-|-|
+|➀|If not using path overrides in `tsconfig.json`, the project must first be built using `npm run build` and `npm run app:workbench-application-platform:build-now:common`|
+
 ## Coding Guidelines
 Besides linting rules, the following rules apply:
 
@@ -174,10 +198,11 @@ npm install -g conventional-changelog-cli
 conventional-changelog -p angular -i resources/site/changelog.md -s
 ```
 
+[link-travis-ci]: https://travis-ci.com/SchweizerischeBundesbahnen/scion-workbench
+
 [menu-overview]: /README.md
-[menu-demo]: https://blog.sbb.technology/scion-workbench-demo/#/(view.6:heatmap//view.5:person/79//view.4:person/39//view.3:person/15//view.2:person/38//view.1:person/66//activity:person-list)?viewgrid=eyJpZCI6MSwic2FzaDEiOlsidmlld3BhcnQuMSIsInZpZXcuMSIsInZpZXcuMiIsInZpZXcuMSJdLCJzYXNoMiI6eyJpZCI6Miwic2FzaDEiOlsidmlld3BhcnQuMiIsInZpZXcuMyIsInZpZXcuMyJdLCJzYXNoMiI6eyJpZCI6Mywic2FzaDEiOlsidmlld3BhcnQuNCIsInZpZXcuNiIsInZpZXcuNiJdLCJzYXNoMiI6WyJ2aWV3cGFydC4zIiwidmlldy40Iiwidmlldy40Iiwidmlldy41Il0sInNwbGl0dGVyIjowLjQ4NTk2MTEyMzExMDE1MTEsImhzcGxpdCI6ZmFsc2V9LCJzcGxpdHRlciI6MC41NTk0MjQzMjY4MzM3OTc1LCJoc3BsaXQiOnRydWV9LCJzcGxpdHRlciI6MC4zMjI2Mjc3MzcyMjYyNzczLCJoc3BsaXQiOmZhbHNlfQ%3D%3D
-[menu-getting-started]: /resources/site/getting-started.md
-[menu-how-to]: /resources/site/how-to.md
+[menu-workbench]: /resources/site/workbench.md
+[menu-workbench-application-platform]: /resources/site/workbench-application-platform.md
 [menu-contributing]: /CONTRIBUTING.md
 [menu-changelog]: /resources/site/changelog.md
 [menu-sponsoring]: /resources/site/sponsors.md

README.md

@@ -1,17 +1,18 @@
 ![SCION Workbench](/resources/site/logo/scion-workbench-banner.png)
 
-[Overview][menu-overview] | [Demo][menu-demo] | [Getting Started][menu-getting-started] | [How To][menu-how-to] | [Contributing][menu-contributing] | [Changelog][menu-changelog] | [Sponsoring][menu-sponsoring] | [Links][menu-links]
-|---|---|---|---|---|---|---|---|
+[Overview][menu-overview] | [Workbench][menu-workbench] | [Workbench Application Platform][menu-workbench-application-platform] | [Contributing][menu-contributing] | [Changelog][menu-changelog] | [Sponsoring][menu-sponsoring] | [Links][menu-links]
+|---|---|---|---|---|---|---|
 
 # Overview
 
-SCION Workbench helps to build multi-view web applications and integrates separate micro frontends into a consistent rich web application. Views are shown within tabs which can be flexible arranged and dragged around by the user.
+SCION Workbench helps to build multi-view web applications and integrates separate micro frontends into a consistent rich web application. Views are shown within tabs which can be flexibly arranged and dragged around by the user.
 
 <a href="https://github.com/SchweizerischeBundesbahnen/scion-workbench/raw/master/resources/site/pics/workbench-large.png">![SCION Workbench](/resources/site/pics/workbench-small.png)</a>
 
 The Workbench provides core features of a modern rich web application.
 -	Tabbed, movable and stackable views
 -	Activity panel as application entry point
+- Popups
 -	Global notifications 
 -	Global or view-local message boxes
 -	URL encoded navigational state
@@ -44,12 +45,12 @@ We would like to thank SBB which supports open source software and made SCION Wo
 ## Current Project Version
 [![Project version](https://img.shields.io/npm/v/@scion/workbench.svg)][menu-download] [![Project version](https://img.shields.io/npm/v/@scion/workbench/next.svg)][menu-download]
 
-[menu-overview]: /README.md
-[menu-demo]: https://blog.sbb.technology/scion-workbench-demo/#/(view.6:heatmap//view.5:person/79//view.4:person/39//view.3:person/15//view.2:person/38//view.1:person/66//activity:person-list)?viewgrid=eyJpZCI6MSwic2FzaDEiOlsidmlld3BhcnQuMSIsInZpZXcuMSIsInZpZXcuMiIsInZpZXcuMSJdLCJzYXNoMiI6eyJpZCI6Miwic2FzaDEiOlsidmlld3BhcnQuMiIsInZpZXcuMyIsInZpZXcuMyJdLCJzYXNoMiI6eyJpZCI6Mywic2FzaDEiOlsidmlld3BhcnQuNCIsInZpZXcuNiIsInZpZXcuNiJdLCJzYXNoMiI6WyJ2aWV3cGFydC4zIiwidmlldy40Iiwidmlldy40Iiwidmlldy41Il0sInNwbGl0dGVyIjowLjQ4NTk2MTEyMzExMDE1MTEsImhzcGxpdCI6ZmFsc2V9LCJzcGxpdHRlciI6MC41NTk0MjQzMjY4MzM3OTc1LCJoc3BsaXQiOnRydWV9LCJzcGxpdHRlciI6MC4zMjI2Mjc3MzcyMjYyNzczLCJoc3BsaXQiOmZhbHNlfQ%3D%3D
 [menu-download]: https://www.npmjs.com/package/@scion/workbench
-[menu-getting-started]: /resources/site/getting-started.md
-[menu-how-to]: /resources/site/how-to.md
+
+[menu-overview]: /README.md
+[menu-workbench]: /resources/site/workbench.md
+[menu-workbench-application-platform]: /resources/site/workbench-application-platform.md
 [menu-contributing]: /CONTRIBUTING.md
 [menu-changelog]: /resources/site/changelog.md
 [menu-sponsoring]: /resources/site/sponsors.md
-[menu-links]: /resources/site/links.md
+[menu-links]: /resources/site/links.md