docs: fold corporate proxy into proxy doc

Author: filipesilva

docs/documentation/stories.md

@@ -21,7 +21,6 @@
  - [Proxy](stories/proxy)
  - [Routing](stories/routing)
  - [3rd Party Lib](stories/third-party-lib)
- - [Corporate Proxy](stories/using-corporate-proxy)
  - [Internationalization (i18n)](stories/internationalization)
  - [Serve from Disk](stories/disk-serve)
  - [Code Coverage](stories/code-coverage)

docs/documentation/stories/proxy.md

@@ -25,7 +25,7 @@ We can then add the `proxyConfig` option to the serve target:
   "serve": {
     "builder": "@angular-devkit/build-angular:dev-server",
     "options": {
-      "browserTarget": "rx-seven-project:build",
+      "browserTarget": "your-application-name:build",
       "proxyConfig": "src/proxy.conf.json"
     },
 ```
@@ -118,7 +118,7 @@ Make sure to point to the right file (`.js` instead of `.json`):
   "serve": {
     "builder": "@angular-devkit/build-angular:dev-server",
     "options": {
-      "browserTarget": "rx-seven-project:build",
+      "browserTarget": "your-application-name:build",
       "proxyConfig": "src/proxy.conf.js"
     },
 ```
@@ -144,3 +144,43 @@ const PROXY_CONFIG = {
 
 module.exports = PROXY_CONFIG;
 ```
+
+### Using corporate proxy
+
+If you work behind a corporate proxy, the regular configuration will not work if you try to proxy
+calls to any URL outside your local network.
+
+In this case, you can configure the backend proxy to redirect calls through your corporate
+proxy using an agent:
+
+```bash
+npm install --save-dev https-proxy-agent
+```
+
+Then instead of using a `proxy.conf.json` file, we create a file called `proxy.conf.js` with
+the following content:
+
+```js
+var HttpsProxyAgent = require('https-proxy-agent');
+var proxyConfig = [{
+  context: '/api',
+  target: 'http://your-remote-server.com:3000',
+  secure: false
+}];
+
+function setupForCorporateProxy(proxyConfig) {
+  var proxyServer = process.env.http_proxy || process.env.HTTP_PROXY;
+  if (proxyServer) {
+    var agent = new HttpsProxyAgent(proxyServer);
+    console.log('Using corporate proxy server: ' + proxyServer);
+    proxyConfig.forEach(function(entry) {
+      entry.agent = agent;
+    });
+  }
+  return proxyConfig;
+}
+
+module.exports = setupForCorporateProxy(proxyConfig);
+```
+
+This way if you have a `http_proxy` or `HTTP_PROXY` environment variable defined, an agent will automatically be added to pass calls through your corporate proxy when running `npm start`.