Skip to content

Commit

Permalink
[INTERNAL] Rename workflow doc and add troubleshooting
Browse files Browse the repository at this point in the history
  • Loading branch information
RandomByte committed Jul 30, 2019
1 parent 57da73c commit 0cf4d88
Show file tree
Hide file tree
Showing 3 changed files with 10 additions and 3 deletions.
7 changes: 7 additions & 0 deletions docs/pages/Troubleshooting.md
Original file line number Diff line number Diff line change
@@ -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".
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
4 changes: 2 additions & 2 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand All @@ -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'
Expand Down

0 comments on commit 0cf4d88

Please sign in to comment.