docs: mention dap configs

README.md

@@ -109,6 +109,44 @@ vim.keymap.set("n", "<leader>E", function() require("powershell").eval() end)
 
 You could also use a filetype autocmd to create the keymap.
 
+## DAP
+
+By default, the plugin includes the following [nvim-dap](https://github.com/mfussenegger/nvim-dap) configurations:
+
+```lua
+dap.configurations.ps1 = {
+  {
+    name = "PowerShell: Launch Current File",
+    type = "ps1",
+    request = "launch",
+    script = "${file}",
+  },
+  {
+    name = "PowerShell: Launch Script",
+    type = "ps1",
+    request = "launch",
+    script = function()
+      return coroutine.create(function(co)
+        vim.ui.input({
+          prompt = 'Enter path or command to execute, for example: "${workspaceFolder}/src/foo.ps1" or "Invoke-Pester"',
+          completion = "file",
+        }, function(selected) coroutine.resume(co, selected) end)
+      end)
+    end,
+  },
+  {
+    name = "PowerShell: Attach to PowerShell Host Process",
+    type = "ps1",
+    request = "attach",
+    processId = "${command:pickProcess}",
+  },
+}
+```
+
+To use them, simply call `require('dap').continue()` inside of a `ps1` file.
+
+**NOTE**: currently, debugging does not support launching an integrated terminal because of [PowerShell/PowerShellEditorServices#2164](https://github.com/PowerShell/PowerShellEditorServices/issues/2164)
+
 ## TODO
 
 - [ ] Tests

lua/powershell/lsp.lua

@@ -323,7 +323,7 @@ M.eval = function()
     :map(function(line) return line .. "\r" end)
     :each(function(line) api.nvim_chan_send(term_channel, line) end)
 
-  -- HACK: for some reason, the neovim terminal does not update when using this
+  -- TODO: wait for response on https://github.com/PowerShell/PowerShellEditorServices/issues/2164
   -- local client = assert(vim.lsp.get_client_by_id(client_id))
   -- client.request("evaluate", { expression = text }, util.noop, 0)
 end