[fuchsia] Add landing README.md to //docs/fuchsia
Include links to all existing .md files.
Also finish updates to //fuchsia_webengine/README.md.
Bug: 1081525
Change-Id: I1dd16ecc3c80d1dd7685ea9067f93203ec4de630
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/3656169
Commit-Queue: David Dorwin <[email protected]>
Reviewed-by: Greg Thompson <[email protected]>
Auto-Submit: David Dorwin <[email protected]>
Cr-Commit-Position: refs/heads/main@{#1005888}
diff --git a/docs/fuchsia/README.md b/docs/fuchsia/README.md
new file mode 100644
index 0000000..a9e682c
--- /dev/null
+++ b/docs/fuchsia/README.md
@@ -0,0 +1,49 @@
+# Fuchsia
+
+Documentation for developing Chromium for the [Fuchsia](https://fuchsia.dev/) platform.
+
+[TOC]
+
+## Contact information
+
+* [`#fuchsia`](https://chromium.slack.com/archives/CGJCHA1SM) on [Chromium Slack](https://www.chromium.org/developers/slack)
+* [[email protected]](mailto:[email protected])
+
+## Bugs
+
+Fuchsia-specific issues should have Component `Fuchsia` and OS `Fuchsia`.
+
+To report a new issue, use this
+[template](https://bugs.chromium.org/p/chromium/issues/entry?components=Fuchsia&labels=OS-Fuchsia%2CType-Bug).
+
+## Chromium development for Fuchsia
+
+See [Checking out and building on Fuchsia](build_instructions.md) for
+Fuchsia-specific build instructions.
+
+### Deploying and running Fuchsia code.
+
+Fuchsia binaries are deployed and executed via scripts that are automatically
+generated by the `fuchsia_package_installer()` or
+`fuchsia_run_script_with_packages()` GN templates.
+
+For information on running tests, see [Tests](#tests).
+
+#### Debugging
+
+See [Debugging](debug_instructions.md)
+
+#### Tests
+
+* [Deploying and running gtests on Fuchsia](gtests.md)
+* [Deploying content_shell and running web_tests on Fuchsia](web_tests.md)
+* [Running GPU integration tests on Fuchsia](gpu_testing.md)
+* [Running Telemetry Benchmarks on Fuchsia](telemetry.md)
+
+## Fuchsia WebEngine and Runners
+See [Fuchsia WebEngine and Runners](../../fuchsia_webengine/README.md).
+
+## Resources for developers working on Chromium for Fuchsia
+
+* [Fuchsia platform versioning](platform_versioning.md)
+* [Manually updating Chromium to a new Fuchsia SDK](sdk_updates.md)
\ No newline at end of file
diff --git a/docs/fuchsia/build_instructions.md b/docs/fuchsia/build_instructions.md
index 0746ece..4b823ca 100644
--- a/docs/fuchsia/build_instructions.md
+++ b/docs/fuchsia/build_instructions.md
@@ -1,8 +1,7 @@
# Checking out and building on Fuchsia
-***If you have followed the instructions below and things still having trouble,
-try `#fuchsia` on [Chromium Slack](https://www.chromium.org/developers/slack)
-or [[email protected]](mailto:[email protected]).***
+***If you have followed the instructions below and are still having trouble,
+see [Contact information](README.md#contact-information).***
There are instructions for other platforms linked from the
[get the code](../get_the_code.md) page.
diff --git a/docs/fuchsia/debug_instructions.md b/docs/fuchsia/debug_instructions.md
index 023b838e..3b5a834 100644
--- a/docs/fuchsia/debug_instructions.md
+++ b/docs/fuchsia/debug_instructions.md
@@ -1,5 +1,7 @@
# Debugging
+[TOC]
+
It is possible to debug Fuchsia binaries using `zxdb`. For the sake of these
examples, we will be using `base_unittests` as the test suite we wish to
execute. These instructions assume that your Chromium build has the following gn
diff --git a/docs/fuchsia/gpu_testing.md b/docs/fuchsia/gpu_testing.md
index 5a61f03..0feade62 100644
--- a/docs/fuchsia/gpu_testing.md
+++ b/docs/fuchsia/gpu_testing.md
@@ -1,4 +1,6 @@
-# Running GPU integration tests on Fuchsia.
+# Running GPU integration tests on Fuchsia
+
+[TOC]
General instruction on running and debugging GPU integration tests can be
found [here](../gpu/gpu_testing.md).
diff --git a/docs/fuchsia/gtests.md b/docs/fuchsia/gtests.md
index 450821d..2253d642 100644
--- a/docs/fuchsia/gtests.md
+++ b/docs/fuchsia/gtests.md
@@ -1,4 +1,6 @@
-# Deploying and running gtests on Fuchsia.
+# Deploying and running gtests on Fuchsia
+
+[TOC]
Fuchsia gtest binaries are deployed and executed via scripts that are
automatically generated by the `test()` GN target. For each test, three wrapper
diff --git a/docs/fuchsia/telemetry.md b/docs/fuchsia/telemetry.md
index 138ebacd..41740f1 100644
--- a/docs/fuchsia/telemetry.md
+++ b/docs/fuchsia/telemetry.md
@@ -1,4 +1,6 @@
-# Running Telemetry Benchmarks on Fuchsia.
+# Running Telemetry Benchmarks on Fuchsia
+
+[TOC]
General instruction on running and debugging benchmarks can be found in the
[`tools/perf/README.md`](../../tools/perf/README.md).
diff --git a/docs/fuchsia/web_tests.md b/docs/fuchsia/web_tests.md
index 911f542..a5d5d79 100644
--- a/docs/fuchsia/web_tests.md
+++ b/docs/fuchsia/web_tests.md
@@ -1,4 +1,6 @@
-# Deploying content_shell and running web_tests on Fuchsia.
+# Deploying content_shell and running web_tests on Fuchsia
+
+[TOC]
General instruction on running and debugging web_tests can be found
[here](../testing/web_tests.md).
