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'