Running servoshell

src/SUMMARY.md

@@ -3,12 +3,12 @@
 [The Servo Book](title-page.md)
 
 - [Getting Servo](getting-servo.md)
+- [Running servoshell](running-servoshell.md)
 
 # Pre-book docs\*
 
 - [README.md\*](old/README.md)
 - [CONTRIBUTING.md\*](old/CONTRIBUTING.md)
-- [docs/COMMAND_LINE_ARGS.md\*](old/COMMAND_LINE_ARGS.md)
 - [docs/STYLE_GUIDE.md\*](old/STYLE_GUIDE.md)
 - [docs/debugging.md\*](old/debugging.md)
 - [docs/glossary.md\*](old/glossary.md)

src/running-servoshell.md

@@ -0,0 +1,31 @@
+# Running servoshell
+
+Assuming you’re in the directory containing `servo`, you can run servoshell with:
+
+```sh
+$ ./servo [url] [options]
+```
+
+Use `--help` to list the available command line options:
+
+```sh
+$ ./servo --help
+```
+
+Use `--pref` to [configure Servo’s behaviour](https://github.com/servo/servo/blob/main/resources/prefs.json), including to enable experimental web platform features.
+For example, to run our [Conway’s Game of Life demo](https://demo.servo.org/experiments/webgpu-game-of-life/) with WebGPU enabled:
+
+```sh
+$ ./servo --pref dom.webgpu.enabled https://demo.servo.org/experiments/webgpu-game-of-life/
+```
+
+Use `--devtools=6080` to enable support for [debugging pages with Firefox devtools](https://firefox-source-docs.mozilla.org/devtools-user/about_colon_debugging/index.html#connecting-over-the-network):
+
+```sh
+$ ./servo --devtools=6080
+```
+
+<div class="warning">
+
+**Note:** devtools support is currently broken ([#29831](https://github.com/servo/servo/issues/29831)).
+</div>