Reorganize analysis server's "new language feature" list and add descriptive text.

Based on discussions for the analysis server implementation of the
wildcards feature (#55681).

Bug: #55681
Change-Id: I8a161ead687ffb71cf18fb573323fbb7c36bf0a3
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/369501
Reviewed-by: Brian Wilkerson <[email protected]>
Reviewed-by: Kallen Tu <[email protected]>
Reviewed-by: Phil Quitslund <[email protected]>
Commit-Queue: Paul Berry <[email protected]>

Author: stereotype441

pkg/analysis_server/doc/process/new_language_feature.md

@@ -18,41 +18,68 @@ Separate issues should be created for each of the items in the list.
 The following is a list of the individual features that need to be considered.
 The features are listed in alphabetical order.
 
-- [ ] Call Hierarchy
-- [ ] Closing Labels
+- [ ] Call Hierarchy (an IDE feature where you can get a call hierarchy if you
+      click on a method)
+- [ ] Closing Labels (an LSP feature allowing the IDE to show lightly grayed out
+      comments at the end of the last line of a multi-line invocation, to aid
+      the user in understanding what invocation is closed by a `)`)
 - [ ] Code Completion
 - [ ] Code Folding
-- [ ] Document Symbols
-- [ ] Document Colors
-- [ ] Flutter Outline
+- [ ] Document Colors (an LSP feature whereby a reference to a color in code can
+      be associated with a colored swatch and a color picker)
 - [ ] Hovers
-- [ ] Implemented Markers
-- [ ] Inlay Hints
-- [ ] Navigation - legacy
-- [ ] Navigation - LSP Go to Definition
-- [ ] Navigation - LSP Go to Type Definition
-- [ ] Navigation - Go to Super
-- [ ] Occurrences - legacy
-- [ ] Occurrences - LSP Document Highlights
+- Implemented/override markers (a legacy protocol feature, only available to
+  IntelliJ and Android Studio)
+  - [ ] Implemented Markers (allows navigation from a base class method to
+        methods that override it, or from a base class to classes that
+        extend/implement it)
+  - [ ] Override Markers (allows navigation from a method to the base class
+        method it overrides, or from a class to the class that it
+        extends/implements)
+- [ ] Inlay Hints (an LSP feature allowing extra information to be displayed
+      using inline hints)
+- Navigation
+  - [ ] Go to Definition (LSP feature)
+  - [ ] Go to Type Definition (LSP feature)
+  - [ ] Go to Super (LSP feature)
+  - [ ] Legacy protocol (for IntelliJ and Android Studio)
+- Occurrences
+  - [ ] Legacy protocol (for IntelliJ and Android Studio)
+  - [ ] Document Highlights (LSP feature)
 - [ ] Organize Imports
-- [ ] Outline
-- [ ] Overrides Markers
-- [ ] Quick Assists
-- [ ] Quick Fixes
-- [ ] Refactorings - legacy
-- [ ] Refactorings - self describing
-- [ ] Search - Find References
-- [ ] Search - Implementations - LSP
-- [ ] Search - Member Declarations
-- [ ] Search - Member References
-- [ ] Search - Top-level Declarations
-- [ ] Selection Range
+- Outline
+  - [ ] Flutter Outline
+  - [ ] Legacy protocol, a.k.a. Document Symbols (for IntelliJ and Android
+        Studio)
+  - [ ] LSP feature
+- Refactorings and quick assists/fixes (note that in addition to potentially
+  creating new refactorings and/or quick assists/fixes, part of the work
+  required to implement a new language feature includes evaluating each existing
+  refactoring and quick fix/assist to see whether it needs to be improved or
+  have test cases added to reflect the new feature).
+  - [ ] Legacy refactorings (for IntelliJ and Android Studio)
+  - [ ] LSP rename refactoring (note that LSP has a special protocol for
+        renames)
+  - [ ] LSP self-describing refactorings
+  - [ ] Quick Assists
+  - [ ] Quick Fixes
+- Search
+  - [ ] Find References
+  - [ ] Implementations - LSP
+  - [ ] Member Declarations
+  - [ ] Member References
+  - [ ] Top-level Declarations
+- [ ] Selection Range (an LSP feature allowing a selection to be expanded to
+      cover the range of an ancestor AST node)
 - Syntax Highlighting
-  - [ ] Semantic Highlights
-  - [ ] LSP Semantic Tokens
-- [ ] Signature Help
+  - [ ] Legacy protocol, a.k.a. Semantic Highlights (for IntelliJ and Android
+        Studio)
+  - [ ] Semantic Tokens (LSP feature)
+- [ ] Signature Help (an LSP feature that tells the parameters and types needed
+      for an invocation)
 - [ ] Snippets
 - [ ] Sort Members
-- [ ] Type Hierarchy - legacy
-- [ ] Type Hierarchy - LSP
-- [ ] Workspace Symbols
+- Type Hierarchy
+  - [ ] Legacy protocol (for IntelliJ and Android Studio)
+  - [ ] LSP feature
+- [ ] Workspace Symbols (LSP feature)