Document why constructor is deprecated

See conversation in eclipse-lsp4j#822 (comment)
jonahgraham · May 14, 2024 · 3a52c0c · 3a52c0c
1 parent c515f17
commit 3a52c0c
Showing 1 changed file with 5 additions and 0 deletions.
diff --git a/org.eclipse.lsp4j/src/main/java/org/eclipse/lsp4j/Protocol.xtend b/org.eclipse.lsp4j/src/main/java/org/eclipse/lsp4j/Protocol.xtend
@@ -104,6 +104,11 @@ class WorkspaceEditCapabilities {
 	new() {
 	}
 
+	/**
+	 * @deprecated because when this class first existed it didn't have any other fields.
+	 * Now that this class has lots of fields, there is nothing special about this
+	 * field and therefore using the setters is the recommended use case.
+	 */
 	@Deprecated
 	new(Boolean documentChanges) {
 		this.documentChanges = documentChanges