docs/dlv-dap.md: add initial documentation for dlv dap
Add some initial documentation for how to use dlv dap.
Updates golang/vscode-go#1264
Change-Id: Icd78b61812f399e341f1c93dfb73bcd261e76da3
Reviewed-on: https://go-review.googlesource.com/c/vscode-go/+/302129
Trust: Suzy Mueller <suzmue@golang.org>
Run-TryBot: Suzy Mueller <suzmue@golang.org>
Reviewed-by: Hyang-Ah Hana Kim <hyangah@gmail.com>
diff --git a/docs/dlv-dap.md b/docs/dlv-dap.md
new file mode 100644
index 0000000..b840cc4
--- /dev/null
+++ b/docs/dlv-dap.md
@@ -0,0 +1,38 @@
+# Dlv DAP - Delve's native DAP implementationa
+
+[`Delve`'s native DAP implementation](https://github.com/go-delve/delve/tree/master/service/dap) is now available to be used to debug Go programs.
+
+This debug adapter runs in a separate `go` process, which is spawned by VS Code when you debug Go code. Since `dlv dap` is under active development, we recommend that `dlv` be installed at master to get all recent updates.
+
+```
+$ GO111MODULES=on go get github.com/go-delve/delve@master
+```
+
+Please see the [Debug Adapter Protocol (DAP)](https://microsoft.github.io/debug-adapter-protocol/) to understand how the Debug Adapter acts as an intermediary between VS Code and the debugger ([Delve](https://github.com/go-delve/delve)).
+
+Follow along with [golang/vscode-go#23](https://github.com/golang/vscode-go/issues/23) and the [project dashboard](https://github.com/golang/vscode-go/projects/3) for updates on the implementation.
+
+## Overview
+
+* [How to use dlv dap](#how-to-use-dlv-dap)
+
+## How to use dlv dap
+
+You can choose which debug adapter to use with the `"debugAdapter"` field in your launch configuration. If you do not already have a `launch.json`, select `create a launch.json file` from the debug pane and choose an initial Go debug configuration.
+
+<div style="text-align: center;"><img src="images/createlaunchjson.png" alt="The debug pane with the option to create launch.json"> </div>
+
+In your launch configuration, set the `"debugAdapter"` field to be `"dlv-dap"`. For example, a launch configuration for a file would look like:
+
+```json5
+{
+ "name": "Launch file",
+ "type": "go",
+ "request": "launch",
+ "mode": "auto",
+ "program": "${file}",
+ "debugAdapter": "dlv-dap"
+}
+```
+
+To switch back to the legacy adapter, set `"debugAdapter"` to `"legacy"`.
\ No newline at end of file
diff --git a/docs/images/createlaunchjson.png b/docs/images/createlaunchjson.png
new file mode 100644
index 0000000..3e670ab
--- /dev/null
+++ b/docs/images/createlaunchjson.png
Binary files differ
