### General
- make the doc VS Code neutral. e.g. VS Code => Development tool
  - make the diagrams VS Code neutral where possible
- do not use WE use the LSP
- Terminology
  - Development Tool instead of client
  - implementations instead of implementors? 

### Contents
- needs link back to the language server repo for filing issues etc. Add a contributing section with links to the repo
- link from protocol to screenshots illustrating how this is exposed (can we link to the VS Code images, have a separate page).
- glossary? development tool (not client), language server, SDK

### Layout
- home page: less space below the header page