Dbaeumer/prepare3.17 (#1467)

* Remove Proposed State

* Remove @proposed

* Include Meta model

* Minor fix to WatchKind

* Update meta model

* Add VersionedNotebookDocumentIdentifier

* 💄

* Update meta model

_data/linkableTypes.yml

@@ -816,6 +816,8 @@
     link: '#didCloseNotebookDocumentParams'
   - type: 'NotebookDocumentIdentifier'
     link: '#notebookDocumentIdentifier'
+  - type: 'VersionedNotebookDocumentIdentifier'
+    link: '#versionedNotebookDocumentIdentifier'
   - type: 'DiagnosticClientCapabilities'
     link: '#diagnosticClientCapabilities'
   - type: 'DiagnosticOptions'

_data/specification-3-17-toc.yml

@@ -282,6 +282,8 @@
     children:
     - title: Implementation Considerations
       anchor: implementationConsiderations
+    - title: Meta Model
+      anchor: metaModel
   - title: Change Log
     anchor: changeLog
     children:

_data/specifications.yml

@@ -1,12 +1,10 @@
 - title: LSP
   anchor: lsp
   children:
-  - title: 3.16 (Current)
-    url: /specifications/specification-current
-  - title: 3.17 (Upcoming)
+  - title: 3.17 (Current)
     url: /specifications/lsp/3.17/specification
-  - title: 3.15 (Previous)
-    url: /specifications/specification-3-15
+  - title: 3.16 (Previous)
+    url: /specifications/specification-3-16
 - title: LSIF
   anchor: lsif
   children:

_specifications/lsif/0.5.0/specification.md

@@ -45,15 +45,15 @@ Principal design goals:
 
 LSP requests that are good candidates to be supported in LSIF are:
 
-- [`textDocument/documentSymbol`](https://microsoft.github.io/language-server-protocol/specifications/specification-current#textDocument_documentSymbol)
-- [`textDocument/foldingRange`](https://microsoft.github.io/language-server-protocol/specifications/specification-current#textDocument_foldingRange)
-- [`textDocument/documentLink`](https://microsoft.github.io/language-server-protocol/specifications/specification-current#textDocument_documentLink)
-- [`textDocument/definition`](https://microsoft.github.io/language-server-protocol/specifications/specification-current#textDocument_definition)
-- [`textDocument/declaration`](https://microsoft.github.io/language-server-protocol/specifications/specification-current#textDocument_declaration)
-- [`textDocument/typeDefinition`](https://microsoft.github.io/language-server-protocol/specifications/specification-current#textDocument_typeDefinition)
-- [`textDocument/hover`](https://microsoft.github.io/language-server-protocol/specifications/specification-3-15#textDocument_hover)
-- [`textDocument/references`](https://microsoft.github.io/language-server-protocol/specifications/specification-3-15#textDocument_references)
-- [`textDocument/implementation`](https://microsoft.github.io/language-server-protocol/specifications/specification-3-15#textDocument_implementation)
+- [`textDocument/documentSymbol`](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification#textDocument_documentSymbol)
+- [`textDocument/foldingRange`](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification#textDocument_foldingRange)
+- [`textDocument/documentLink`](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification#textDocument_documentLink)
+- [`textDocument/definition`](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification#textDocument_definition)
+- [`textDocument/declaration`](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification#textDocument_declaration)
+- [`textDocument/typeDefinition`](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification#textDocument_typeDefinition)
+- [`textDocument/hover`](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification#textDocument_hover)
+- [`textDocument/references`](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification#textDocument_references)
+- [`textDocument/implementation`](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification#textDocument_implementation)
 
 The corresponding LSP requests have one of the following two forms:
 

_specifications/lsif/0.6.0/specification.md

@@ -49,15 +49,15 @@ Principal design goals:
 
 LSP requests that are good candidates to be supported in LSIF are:
 
-- [`textDocument/documentSymbol`](https://microsoft.github.io/language-server-protocol/specifications/specification-current#textDocument_documentSymbol)
-- [`textDocument/foldingRange`](https://microsoft.github.io/language-server-protocol/specifications/specification-current#textDocument_foldingRange)
-- [`textDocument/documentLink`](https://microsoft.github.io/language-server-protocol/specifications/specification-current#textDocument_documentLink)
-- [`textDocument/definition`](https://microsoft.github.io/language-server-protocol/specifications/specification-current#textDocument_definition)
-- [`textDocument/declaration`](https://microsoft.github.io/language-server-protocol/specifications/specification-current#textDocument_declaration)
-- [`textDocument/typeDefinition`](https://microsoft.github.io/language-server-protocol/specifications/specification-current#textDocument_typeDefinition)
-- [`textDocument/hover`](https://microsoft.github.io/language-server-protocol/specifications/specification-3-15#textDocument_hover)
-- [`textDocument/references`](https://microsoft.github.io/language-server-protocol/specifications/specification-3-15#textDocument_references)
-- [`textDocument/implementation`](https://microsoft.github.io/language-server-protocol/specifications/specification-3-15#textDocument_implementation)
+- [`textDocument/documentSymbol`](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification#textDocument_documentSymbol)
+- [`textDocument/foldingRange`](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification#textDocument_foldingRange)
+- [`textDocument/documentLink`](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification#textDocument_documentLink)
+- [`textDocument/definition`](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification#textDocument_definition)
+- [`textDocument/declaration`](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification#textDocument_declaration)
+- [`textDocument/typeDefinition`](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification#textDocument_typeDefinition)
+- [`textDocument/hover`](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification#textDocument_hover)
+- [`textDocument/references`](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification#textDocument_references)
+- [`textDocument/implementation`](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification#textDocument_implementation)
 
 The corresponding LSP requests have one of the following two forms:
 

_specifications/lsp/3.17/general/initialize.md

@@ -264,21 +264,21 @@ export interface TextDocumentClientCapabilities {
 	/**
 	 * Capabilities specific to the various type hierarchy requests.
 	 *
-	 * @since 3.17.0 - proposed state
+	 * @since 3.17.0
 	 */
 	typeHierarchy?: TypeHierarchyClientCapabilities;
 
 	/**
 	 * Capabilities specific to the `textDocument/inlineValue` request.
 	 *
-	 * @since 3.17.0 - proposed state
+	 * @since 3.17.0
 	 */
 	inlineValue?: InlineValueClientCapabilities;
 
 	/**
 	 * Capabilities specific to the `textDocument/inlayHint` request.
 	 *
-	 * @since 3.17.0 - proposed state
+	 * @since 3.17.0
 	 */
 	inlayHint?: InlayHintClientCapabilities;
 
@@ -302,14 +302,12 @@ export interface TextDocumentClientCapabilities {
  * Capabilities specific to the notebook document support.
  *
  * @since 3.17.0
- * @proposed
  */
 export interface NotebookDocumentClientCapabilities {
 	/**
 	 * Capabilities specific to notebook document synchronization
 	 *
 	 * @since 3.17.0
-	 * @proposed
 	 */
 	synchronization: NotebookDocumentSyncClientCapabilities;
 }
@@ -438,24 +436,21 @@ interface ClientCapabilities {
 		/**
 		 * Client workspace capabilities specific to inline values.
 		 *
-		 * @since 3.17.0 - proposed state
-		 * @proposed
+		 * @since 3.17.0
 		 */
 		inlineValue?: InlineValueWorkspaceClientCapabilities;
 
 		/**
 		 * Client workspace capabilities specific to inlay hints.
 		 *
-		 * @since 3.17.0 - proposed state
-		 * @proposed
+		 * @since 3.17.0
 		 */
 		inlayHint?: InlayHintWorkspaceClientCapabilities;
 
 		/**
 		 * Client workspace capabilities specific to diagnostics.
 		 *
 		 * @since 3.17.0.
-		 * @proposed
 		 */
 		diagnostics?: DiagnosticWorkspaceClientCapabilities;
 	};
@@ -469,7 +464,6 @@ interface ClientCapabilities {
 	 * Capabilities specific to the notebook document support.
 	 *
 	 * @since 3.17.0
-	 * @proposed
 	 */
 	notebookDocument?: NotebookDocumentClientCapabilities;
 
@@ -566,7 +560,6 @@ interface ClientCapabilities {
 		 * side.
 		 *
 		 * @since 3.17.0
-		 * @proposed
 		 */
 		positionEncodings?: PositionEncodingKind[];
 	};
@@ -664,7 +657,6 @@ interface ServerCapabilities {
 	 * If omitted it defaults to 'utf-16'.
 	 *
 	 * @since 3.17.0
-	 * @proposed
 	 */
 	positionEncoding?: PositionEncodingKind;
 
@@ -680,7 +672,6 @@ interface ServerCapabilities {
 	 * Defines how notebook documents are synced.
 	 *
 	 * @since 3.17.0
-	 * @proposed
 	 */
 	notebookDocumentSync?: NotebookDocumentSyncOptions
 		| NotebookDocumentSyncRegistrationOptions;
@@ -846,23 +837,23 @@ interface ServerCapabilities {
 	/**
 	 * The server provides type hierarchy support.
 	 *
-	 * @since 3.17.0 - proposed state
+	 * @since 3.17.0
 	 */
 	typeHierarchyProvider?: boolean | TypeHierarchyOptions
 		 | TypeHierarchyRegistrationOptions;
 
 	/**
 	 * The server provides inline values.
 	 *
-	 * @since 3.17.0 - proposed state
+	 * @since 3.17.0
 	 */
 	inlineValueProvider?: boolean | InlineValueOptions
 		 | InlineValueRegistrationOptions;
 
 	/**
 	 * The server provides inlay hints.
 	 *
-	 * @since 3.17.0 - proposed state
+	 * @since 3.17.0
 	 */
 	inlayHintProvider?: boolean | InlayHintOptions
 		 | InlayHintRegistrationOptions;
@@ -871,7 +862,6 @@ interface ServerCapabilities {
 	 * The server has support for pull model diagnostics.
 	 *
 	 * @since 3.17.0
-	 * @proposed
 	 */
 	diagnosticProvider?: DiagnosticOptions | DiagnosticRegistrationOptions;
 

_specifications/lsp/3.17/language/codeAction.md

@@ -305,7 +305,7 @@ export interface CodeActionContext {
 /**
  * The reason why code actions were requested.
  *
- * @since 3.17.0 - proposed state
+ * @since 3.17.0
  */
 export namespace CodeActionTriggerKind {
 	/**

_specifications/lsp/3.17/language/completion.md

@@ -115,7 +115,7 @@ export interface CompletionClientCapabilities {
 		 * The client has support for completion item label
 		 * details (see also `CompletionItemLabelDetails`).
 		 *
-		 * @since 3.17.0 - proposed state
+		 * @since 3.17.0
 		 */
 		labelDetailsSupport?: boolean;
 	};
@@ -144,15 +144,15 @@ export interface CompletionClientCapabilities {
 	 * The client's default when the completion item doesn't provide a
 	 * `insertTextMode` property.
 	 *
-	 * @since 3.17.0 - proposed state
+	 * @since 3.17.0
 	 */
 	insertTextMode?: InsertTextMode;
 
 	/**
 	 * The client supports the following `CompletionList` specific
 	 * capabilities.
 	 *
-	 * @since 3.17.0 - proposed state
+	 * @since 3.17.0
 	 */
 	completionList?: {
 		/**
@@ -163,7 +163,7 @@ export interface CompletionClientCapabilities {
 		 * `CompletionList.itemDefaults` object. If omitted
 		 * no properties are supported.
 		 *
-		 * @since 3.17.0 - proposed state
+		 * @since 3.17.0
 		 */
 		itemDefaults?: string[];
 	}
@@ -218,15 +218,15 @@ export interface CompletionOptions extends WorkDoneProgressOptions {
 	 * The server supports the following `CompletionItem` specific
 	 * capabilities.
 	 *
-	 * @since 3.17.0 - proposed state
+	 * @since 3.17.0
 	 */
 	completionItem?: {
 		/**
 		 * The server has support for completion item label
 		 * details (see also `CompletionItemLabelDetails`) when receiving
 		 * a completion item in a resolve call.
 		 *
-		 * @since 3.17.0 - proposed state
+		 * @since 3.17.0
 		 */
 		labelDetailsSupport?: boolean;
 	}
@@ -344,20 +344,20 @@ export interface CompletionList {
 	 * signals support for this via the `completionList.itemDefaults`
 	 * capability.
 	 *
-	 * @since 3.17.0 - proposed state
+	 * @since 3.17.0
 	 */
 	itemDefaults?: {
 		/**
 		 * A default commit character set.
 		 *
-		 * @since 3.17.0 - proposed state
+		 * @since 3.17.0
 		 */
 		commitCharacters?: string[];
 
 		/**
 		 * A default edit range
 		 *
-		 * @since 3.17.0 - proposed state
+		 * @since 3.17.0
 		 */
 		editRange?: Range | {
 			insert: Range;
@@ -367,14 +367,14 @@ export interface CompletionList {
 		/**
 		 * A default insert text format
 		 *
-		 * @since 3.17.0 - proposed state
+		 * @since 3.17.0
 		 */
 		insertTextFormat?: InsertTextFormat;
 
 		/**
 		 * A default insert text mode
 		 *
-		 * @since 3.17.0 - proposed state
+		 * @since 3.17.0
 		 */
 		insertTextMode?: InsertTextMode;
 	}
@@ -498,7 +498,7 @@ export type InsertTextMode = 1 | 2;
 /**
  * Additional details for a completion item label.
  *
- * @since 3.17.0 - proposed state
+ * @since 3.17.0
  */
 export interface CompletionItemLabelDetails {
 
@@ -537,7 +537,7 @@ export interface CompletionItem {
 	/**
 	 * Additional details for the label
 	 *
-	 * @since 3.17.0 - proposed state
+	 * @since 3.17.0
 	 */
 	labelDetails?: CompletionItemLabelDetails;
 
@@ -669,7 +669,6 @@ export interface CompletionItem {
 	 * property is used as a text.
 	 *
 	 * @since 3.17.0
-	 * @proposed
 	 */
 	textEditText?: string;
 

_specifications/lsp/3.17/language/foldingRange.md

@@ -38,7 +38,6 @@ export interface FoldingRangeClientCapabilities {
 	 * Specific options for the folding range kind.
 	 *
 	 * @since 3.17.0
-	 * @proposed
 	 */
 	foldingRangeKind? : {
 		/**
@@ -53,15 +52,13 @@ export interface FoldingRangeClientCapabilities {
 	/**
 	 * Specific options for the folding range.
 	 * @since 3.17.0
-	 * @proposed
 	 */
 	foldingRange?: {
 		/**
 		* If set, the client signals that it supports setting collapsedText on
 		* folding ranges to display custom labels instead of the default text.
 		*
 		* @since 3.17.0
-		* @proposed
 		*/
 		collapsedText?: boolean;
 	};