Skip to content

Commit 3fb5d47

Browse files
authored
Docs: Update "How to run things locally" (#24097)
* Recommend a local server, don't present it as second option Current wording offers two options and suggests we'll explain both, but then only explains the second. As discussed in #15334 we should not encourage users to change their browser's security settings. * Clean up
1 parent 019fa1a commit 3fb5d47

File tree

1 file changed

+11
-13
lines changed

1 file changed

+11
-13
lines changed

docs/manual/en/introduction/How-to-run-things-locally.html

Lines changed: 11 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -21,21 +21,19 @@ <h2>Content loaded from external files</h2>
2121
security restrictions, loading from a file system will fail with a security exception.
2222
</p>
2323

24-
<p>There are two ways to solve this:</p>
25-
26-
<ol>
27-
<li>
28-
Change security for local files in a browser. This allows you to access your page as: <code>file:///yourFile.html</code>
29-
</li>
30-
<li>
31-
Run files from a local web server. This allows you to access your page as: <code>http://localhost/yourFile.html</code>
32-
</li>
33-
</ol>
24+
<p>
25+
To solve this, run files from a local web server. This allows you to access your page as:
26+
</p>
27+
28+
<p>
29+
<code>http://localhost/yourFile.html</code>
30+
</p>
3431

3532
<p>
36-
If you use option 1, be aware that you may open yourself to some vulnerabilities if using
37-
the same browser for a regular web surfing. You may want to create a separate browser
38-
profile / shortcut used just for local development to be safe. Let's go over each option in turn.
33+
While it is also possible to change browser security settings instead of running a local server,
34+
we do not recommend that approach. Doing so may open your device up to vulnerabilities, if the
35+
same browser is used for regular web surfing. Use of a local server is standard practice in
36+
web development, and we explain how to install and use a local server below.
3937
</p>
4038
</div>
4139

0 commit comments

Comments
 (0)