Adjusted alphabetical sorting by language #1323
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
The first column of the language server table is the Language, and it is mostly alphabetically sorted. A year or more ago, last time I checked this list, it was fully alphabetically sorted by the language name. However today there are a few entries that were not placed in the table following that precedent, and this makes it confusing to read or scan the table. This moves those confusing items so the table is once again alphabetically sorted by language. I have moved: * Deno to between Delphi and Dockerfiles * The IBM servers for High Level Assembler to A for Assembler * The IBM servers for COBOL to C, for COBOL * Crane PHP to PHP * JSON to the end of the J section * T_SQL from between R and S, to T. This is because T-SQL is not quite the same as SQL (note: it was not sorted as SQL anyway) Where the language is now not the first word in the table cell, I have bolded the language name: "IBM Enterprise **COBOL** for z/OS". Scanning the table, this seems to read well and makes the language name clear in the language column. As well as the ones I moved, I added this formatting to IBM PL/I as well which was already sorted as P for PL/I, same for IBM LALR (already under L.) Most languages here just list the language, not the product, whereas other than Deno the confusingly sorted ones mix in a product or brand name with the language (eg Crane PHP is, as far as I can tell, a language server for PHP, not a fork of the PHP language itself; IBM COBOL is, well, COBOL; the IBM assemblers are more difficult since assemblers are different for different targets, and these are for z/OS, but I sorted under A for Assembler. IMO this is fine since there are no servers listed for other assembly languages yet.) Another alternative would be to remove all product or branding in the Language column, and either add a new column or use the Maintainer column for that information, keeping the language column only for the language name.
|
Thanks! |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
The first column of the language server table is the Language, and it is mostly alphabetically sorted. A year or more ago, last time I checked this list, it was fully alphabetically sorted by the language name. However today there are a few entries that were not placed in the table following that precedent, and this makes it confusing to read or scan the table. This moves those confusing items so the table is once again alphabetically sorted by language.
I have moved:
Of course, a request to change how something is sorted by someone more familiar with the language (I know only what Google shows about T-SQL vs SQL, for example) is very welcome. The goal here is to clean up the table.
Where the language is now not the first word in the table cell, I have bolded the language name: "IBM Enterprise COBOL for z/OS". Scanning the table, this seems to read well and makes the language name clear in the language column. As well as the ones I moved, I added this formatting to IBM PL/I as well which was already sorted as P for PL/I, same for IBM LALR (already under L.)
Most languages here just list the language, not the product, whereas other than Deno the confusingly sorted ones mix in a product or brand name with the language (eg Crane PHP is, as far as I can tell, a language server for PHP, not a fork of the PHP language itself; IBM COBOL is, well, COBOL; the IBM assemblers are more difficult since assemblers are different for different targets, and these are for z/OS, but I sorted under A for Assembler. IMO this is fine since there are no servers listed for other assembly languages yet.) Another alternative would be to remove all product or branding in the Language column, and either add a new column or use the Maintainer column for that information, keeping the language column only for the language name.