docs: add Home/footer/sidebar/faq, move release_plan.md
For golang/vscode-go#2094
Change-Id: I2170fe3755214f1b6390f3292b2a3601797ae359
Reviewed-on: https://go-review.googlesource.com/c/vscode-go/+/400356
Reviewed-by: Suzy Mueller <suzmue@golang.org>
diff --git a/docs/Home.md b/docs/Home.md
new file mode 100644
index 0000000..587da85
--- /dev/null
+++ b/docs/Home.md
@@ -0,0 +1,8 @@
+## 📣 News and Upcoming Changes
+
+[Remote attach debugging](./debugging#connecting-to-headless-delve-with-target-specified-at-server-start-up) is now available via Delve's native DAP implementation with Delve v1.7.3 or newer.
+We plan to enable this as the default in 2022 H1 to enhance remote debugging with the same
+[debugging features](./debugging.md) that are already in use for local debugging.
+We recommend switching your remote attach configurations in `launch.json` to use
+`"debugAdapter":"dlv-dap"` now to verify that this works for you.
+Please [file a new issue](https://github.com/golang/vscode-go/issues/new/choose) if you encounter any problems.
diff --git a/docs/_Footer.md b/docs/_Footer.md
new file mode 100644
index 0000000..b08860c
--- /dev/null
+++ b/docs/_Footer.md
@@ -0,0 +1,3 @@
+### Want to contribute to this Wiki?
+
+Update the source in the [vscode-go project's docs](https://github.com/golang/vscode-go/tree/master/docs) directory, and send a pull request.
diff --git a/docs/_Sidebar.md b/docs/_Sidebar.md
new file mode 100644
index 0000000..96a0f8f
--- /dev/null
+++ b/docs/_Sidebar.md
@@ -0,0 +1,21 @@
+**For Users**
+* [[features]]
+* [[command]]
+* [[settings]]
+* [[debugging]]
+* [[tasks]]
+* [[tools]]
+* [[ui]]
+* [[faq]]
+* [[troubleshooting]]
+* [[advanced]]
+* [[nightly]]
+* [[contributing]]
+
+**For Developers**
+* [[release_plan]]
+* [[smoke test]]
+* [[test explorer]]
+* [[debug adapter]]
+* [Go Language Server](https://go.dev/s/gopls)
+* [Delve DAP](https://github.com/go-delve/delve/tree/master/Documentation/api/dap)
diff --git a/docs/faq.md b/docs/faq.md
new file mode 100644
index 0000000..d739e49
--- /dev/null
+++ b/docs/faq.md
@@ -0,0 +1,29 @@
+### Syntax highlighting does not seem to work.
+
+The default syntax highlighting for Go files is provided by a
+[TextMate rule](https://github.com/jeff-hykin/better-go-syntax) embedded in VS Code,
+not by this extension.
+
+For better syntax highlighting (including generics support), we recommend enabling
+[semantic highlighting](https://code.visualstudio.com/api/language-extensions/semantic-highlight-guide)
+by turning on [Gopls' `ui.semanticTokens` setting](https://github.com/golang/vscode-go/blob/master/docs/settings.md#uisemantictokens).
+
+```json
+"gopls": { "ui.semanticTokens": true }
+```
+
+<!-- Topics
+ * The extension deletes my code on save?
+ * Help! The extension does not find 'go'.
+ * Intellisense is not working!
+ * Should I configure GOROOT/GOPATH?
+ * How can I work with multiple modules?
+ * How can I use my own formatter?
+ * How can I work with build tags?
+ * What is gopls?
+ * Does the extension work on WSL? How?
+ * Does the extension work on browser-based editors?
+ * Can I contribute to share my snippets?
+ * What is the extension's Go version support policy?
+ ...
+-->
\ No newline at end of file
diff --git a/.github/release_plan.md b/docs/release_plan.md
similarity index 100%
rename from .github/release_plan.md
rename to docs/release_plan.md
