sf env: update help and package.json (topic description) (#97)

* fix: clean up "env" help and package.json file

* fix: update help for "sf env list"

remove --all info and stuff about compute environments

Author: jshackell-sfdc

messages/list.md

@@ -4,39 +4,45 @@ List the environments you’ve created or logged into.
 
 # description
 
-By default, the command displays only active environments. For orgs, active means unexpired scratch orgs and orgs you’re currently logged into. For compute environments, active means the environments connected to orgs you’re currently logged into. Use the --all flag to list expired or deleted scratch orgs and compute environments that aren’t connected to logged-in orgs. Warning: the latter list could be very long.
+The command displays only active environments. For orgs, active means unexpired scratch orgs and orgs you’re currently logged into. 
 
-Output is displayed in multiple tables, one for each environment type. For example, the Salesforce Orgs table lists the non-scratch orgs you’re logged into, such as sandboxes, Dev Hubs, production orgs, and so on. Scratch orgs and compute environments get their own tables.
+Output is displayed in multiple tables, one for each environment type. For example, the Salesforce Orgs table lists the non-scratch orgs you’re logged into, such as sandboxes, Dev Hubs, production orgs, and so on. Scratch orgs get their own table.
 
-For non-scratch orgs, the Username column refers to the user you logged into the org with. For scratch orgs it refers to the username that was generated for you when you created the scratch org. The first column indicates the default environment for each type.
+For non-scratch orgs, the Username column refers to the user you logged into the org with. For scratch orgs it refers to the username that was generated for you when you created the scratch org. The table also displays the default environment for each type, the instance URL, and how you authorized (logged into) the org, either using a web browser or JWT.
+
+Use the table-manipulation flags, such as --filter and --sort, to change how the data is displayed. 
 
 Run "sf env display" to view details about a specific environment.
 
 # examples
 
-- List all environments:
-
-  <%= config.bin %> <%= command.id %> --all
-
-- Filter the output to list only connected orgs. Rows from only the Salesforce Orgs table are displayed because it’s the only table with a "Status" column.
+- List all active environments:
 
-  <%= config.bin %> <%= command.id %> --filter "Status=Connected"
+  <%= config.bin %> <%= command.id %>
 
-- List only scratch orgs that expire after May 30, 2021:
+- Filter the output to list only orgs you authorized using a web browser; "OAuth Method" is the name of a column:
 
-  <%= config.bin %> <%= command.id %> --filter "Expiration>2021-05-30"
+  <%= config.bin %> <%= command.id %> --filter "OAuth Method=web"
 
 - Display only the Alias column and sort the aliases in descending order:
 
   <%= config.bin %> <%= command.id %> --sort "-Alias" --columns "Alias"
 
+- Don't truncate the displayed output:
+
+  <%= config.bin %> <%= command.id %> --no-truncate
+  
+- Display only the table data, not the headers, in comma-separated value (csv) format:
+
+  <%= config.bin %> <%= command.id %> --csv --no-header
+
 # flags.extended.summary
 
 Show extra columns.
 
 # flags.columns.summary
 
-Only show provided columns.
+List of columns to display.
 
 # flags.csv.summary
 
@@ -52,15 +58,15 @@ Hide table header from output.
 
 # flags.no-truncate.summary
 
-Do not truncate output to fit screen.
+Don't truncate output to fit screen.
 
 # flags.output.summary
 
-Output in a more machine friendly format.
+Format in which to display the output. 
 
 # flags.sort.summary
 
-Property to sort by (prepend '-' for descending).
+Column to sort by (prepend '-' for descending).
 
 # error.NoAuthsAvailable
 

package.json

@@ -79,7 +79,7 @@
     ],
     "topics": {
       "env": {
-        "description": "Commands to work with enviornments."
+        "description": "Manage your environments, such as orgs."
       }
     }
   },