* Minor formal improvements throughout the LSP spec
This mostly fixes some grammar, spelling, and punctuation issues
throughout version 3.18 of the LSP specification. Additionally,
some incorrect TypeScript syntax has been fixed.
Meta model files have not been changed.
* Fix EBNF grammar for snippets
To be precise, "fix" refers to the following changes in this commit:
* Incorrect grouping of alternatives has been remedied
* Ambiguities present in the grammar have been fixed,
the grammar should now be LL(1)-parseable.
* Grammar has been made consistent with the description above it.
Specifically, characters which have to be escaped per the textual
description now also need to be escaped per the grammar rules.
* A description for the ':+', ':?', and ':-' modifiers has been
added, as they seem to not be explained anywhere else in the spec.
* I have used the VSCode source code as a basis for these.
* The link has been updated to refer to the right EBNF specification,
as the grammar uses the XML variant rather than the one described
in the originally linked Wikipedia article.
* Address review comments by @dbaeumer
---------
Co-authored-by: Dirk Bäumer <dirkb@microsoft.com>
* Define separate tools protocol
Add note
Move the other bits
Define separate tools protocol
Rename to base protocol
Change version to 0.9
Use Base prefix and remove since annotations
Undo changes in LSP specs
Move all the lifecycle messages
Define separate tools protocol
* Move shared definitions
* Define regexes
* List reserved capabilities and improve examples
* Specs for work done progress
* Change enumeration example
* Make ClientCapabilities open
* Add InitializeResponse
* Remove text document stuff from registration messages
* Add motivation section
* Add experimental remark
* Point internal links to the correct LSP spec
For the LSP specs, the internal links will resolve to anchors in the same document.
For the LSIF, the variable `lspVersion` in the front-matter identifies the
corresponding LSP spec that this LSIF spec references.
* Use a Map instead of Object
* Remove external links which are not needed any more
* Remove Proposed State
* Remove @Proposed
* Include Meta model
* Minor fix to WatchKind
* Update meta model
* Add VersionedNotebookDocumentIdentifier
* 💄
* Update meta model
- Found that adding a newline after the anchor holders would result in the markdown coloring not getting corrupted in VSCode + no impact on the actual rendered output. Therefore went back and ensured there was a newline after every anchor.
- Had to update the CSS to account for the linkability of these pieces because when you'd navigate to them they'd be hidden by the top nav bar.
- Broke up several "huge" code sections into smaller segments. In practice it actually looks a lot cleaner but more importantly it allows us to link to individual pieces.
- Also allowed linking off to other pages if we want.
- This method includes a JavaScript snippet that post-processes the site to link out any code snippets/code types to corresponding links.
