From d513b6da45f739d177023ea305538c18b448429b Mon Sep 17 00:00:00 2001
From: polinasok <51177946+polinasok@users.noreply.github.com>
Date: Tue, 3 May 2022 10:35:56 -0700
Subject: [PATCH] Documentation: add DAP launch/attach configuration matrix
 (#2991)

Co-authored-by: Polina Sokolova <polinasok@users.noreply.github.com>
---
 Documentation/api/dap/README.md | 30 ++++++++++++++++++++++++++++--
 1 file changed, 28 insertions(+), 2 deletions(-)

diff --git a/Documentation/api/dap/README.md b/Documentation/api/dap/README.md
index fa906c62..a67b1d52 100644
--- a/Documentation/api/dap/README.md
+++ b/Documentation/api/dap/README.md
@@ -22,8 +22,34 @@ See [dap.Server.handleRequest](https://github.com/go-delve/delve/search?q=handle
 ## Launch and Attach Configurations
 
 In addition to the general [DAP spec](https://microsoft.github.io/debug-adapter-protocol/specification), the server supports the following implementation-specific configuration options for starting the debug session:
-   * [LaunchRequestArguments](https://microsoft.github.io/debug-adapter-protocol/specification#Requests_Launch) - see [LaunchConfig godoc](https://pkg.go.dev/github.com/go-delve/delve/service/dap#LaunchConfig)
-   * [AttachRequestArguments](https://microsoft.github.io/debug-adapter-protocol/specification#Requests_Attach) - see [AttachConfig godoc](https://pkg.go.dev/github.com/go-delve/delve/service/dap#AttachConfig)
+
+<table border=1>
+<tr><th>request<th>mode<th>required<th colspan=9>optional<th></tr>
+<tr><td rowspan=5>launch<br><a href="https://pkg.go.dev/github.com/go-delve/delve/service/dap#LaunchConfig">godoc</a>
+    <td>debug<td>program               <td>dlvCwd<td>env<td>backend<td>args<td>cwd<td>buildFlags<td>output<td>noDebug
+    <td rowspan=7>
+    substitutePath<br>
+    stopOnEntry<br>
+    stackTraceDepth<br>
+    showGlobalVariables<br>
+    showRegisters<br>
+    hideSystemGoroutines<br>
+    goroutineFilters
+    </tr>
+<tr>
+    <td>test<td>program                <td>dlvCwd<td>env<td>backend<td>args<td>cwd<td>buildFlags<td>output<td>noDebug</tr>
+<tr>
+    <td>exec<td>program                <td>dlvCwd<td>env<td>backend<td>args<td>cwd<td>          <td>      <td>noDebug</tr>
+<tr>
+    <td>core<td>program<br>corefilePath<td>dlvCwd<td>env<td>       <td>    <td>   <td>          <td>      <td>       </tr>
+<tr>
+    <td>replay<td>traceDirPath         <td>dlvCwd<td>env<td>       <td>    <td>   <td>          <td>      <td>       </tr>
+<tr><td rowspan=2>attach<br><a href="https://pkg.go.dev/github.com/go-delve/delve/service/dap#AttachConfig">godoc</a>
+    <td>local<td>processId             <td>      <td>   <td>backend<td>   <td>    <td>          <td>      <td>        </tr>
+<tr>
+    <td>remote<td>                     <td>      <td>   <td>       <td>   <td>    <td>          <td>      <td>        </tr>
+</table>
+
 
 Not all of the configurations are supported by each of the two available DAP servers: