Writer: @weinand
Reviewer: @roblourens

• Page: https://vscode-ext-docs.azurewebsites.net/api/extension-guides/debug-extension
• File to edit: https://github.com/Microsoft/vscode-docs/blob/ext-docs/api/extension-guides/debug-extension.md

The problems:

• This page does not link to the new DAP website
• This page does not include updated illustrations such as those in this blog post, making it harder to understand the purpose of DAP (solving the ide*runtime debugging problem), and the way DAP works (as illustrated in the message communication image)

Here are some inspirations, from docs I was trying to make for LSP:

• https://vscode-ext-docs.azurewebsites.net/api/language-extensions/overview#programmatic-language-features
• https://vscode-ext-docs.azurewebsites.net/api/language-extensions/smart-editing-lsp-guide

The todo:

• Update the page so it points to DAP website
• Use the updated illustration from the blog post to better explain DAP and the way it works
• Update the Debugger section of Extension Capabilities Overview page too. Include a short passage that explains what Debug Extension is capable of and point them to the more detailed guide. File to edit is: https://github.com/Microsoft/vscode-docs/blob/ext-docs/api/extension-capabilities/overview.md