From 0cf4d88c56f4c149569a3bb94383ffafa6fcfbc3 Mon Sep 17 00:00:00 2001
From: Merlin Beutlberger <m.beutlberger@sap.com>
Date: Tue, 30 Jul 2019 11:03:37 +0200
Subject: [PATCH] [INTERNAL] Rename workflow doc and add troubleshooting

---
 docs/pages/Troubleshooting.md                         | 7 +++++++
 docs/pages/{WorkingWithUi5Tooling.md => Workflows.md} | 2 +-
 mkdocs.yml                                            | 4 ++--
 3 files changed, 10 insertions(+), 3 deletions(-)
 create mode 100644 docs/pages/Troubleshooting.md
 rename docs/pages/{WorkingWithUi5Tooling.md => Workflows.md} (99%)

diff --git a/docs/pages/Troubleshooting.md b/docs/pages/Troubleshooting.md
new file mode 100644
index 0000000000..c650c11e45
--- /dev/null
+++ b/docs/pages/Troubleshooting.md
@@ -0,0 +1,7 @@
+# Troubleshooting
+## UI5 Server
+### Chrome redirects HTTP URLs to HTTPS (`ERR_SSL_PROTOCOL_ERROR`)
+An HTTPS server or proxy that was previously running on a domain (e.g. `localhost`), might have set an HSTS header, enforcing Chrome to always use HTTPS for this domain. See https://www.chromium.org/hsts. This makes it impossible to connect to an HTTP-only server running on the same domain.
+
+#### Resolution
+You need to delete the HSTS mapping in [chrome://net-internals/#hsts](chrome://net-internals/#hsts) by entering the domain name (e.g. `localhost`) and pressing "delete".
diff --git a/docs/pages/WorkingWithUi5Tooling.md b/docs/pages/Workflows.md
similarity index 99%
rename from docs/pages/WorkingWithUi5Tooling.md
rename to docs/pages/Workflows.md
index 843d0398da..c55e9c5951 100644
--- a/docs/pages/WorkingWithUi5Tooling.md
+++ b/docs/pages/Workflows.md
@@ -1,4 +1,4 @@
-# Working With the UI5 Tooling
+# Workflows
 When developing a UI5 project locally, you should use the UI5 Server (`ui5 serve`) and not the UI5 Builder (`ui5 build`). Building a project should only ever be required when deploying it.
 
 However, you might have good reasons to also use the UI5 Builder during development. In such cases, feel free to let us know! Maybe your use case could be covered by a future enhancement of the UI5 Server.
diff --git a/mkdocs.yml b/mkdocs.yml
index bf84d97ea5..07a483f591 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -7,8 +7,7 @@ site_dir: 'site' # default
 nav:
     - Home: index.md
     - Getting Started: pages/GettingStarted.md
-    - Working with the UI5 Tooling:
-      - Overview: pages/WorkingWithUi5Tooling.md
+    - Workflows: pages/Workflows.md
     - Configuration: pages/Configuration.md
     - CLI: pages/CLI.md
     - Modules:
@@ -22,6 +21,7 @@ nav:
     - Upgrade Guides:
       - Migrate to v1: updates/migrate-v1.md
     - FAQ: pages/FAQ.md
+    - Troubleshooting: pages/Troubleshooting.md
     - API Reference: 'api/index.html' # only available in final build, not serve
 theme:
   name: 'material'