Docs: cleans up Slack CLI reference docs with proper spaces

docs/reference/commands/slack.md

@@ -1,18 +1,18 @@
-## slack
+# `slack`
 
 Slack command-line tool
 
-### Synopsis
+## Synopsis
 
 CLI to create, run, and deploy Slack apps
 
-Get started by reading the docs: [https://tools.slack.dev/deno-slack-sdk](/deno-slack-sdk)
+Get started by reading the docs: [https://tools.slack.dev/slack-cli](https://tools.slack.dev/slack-cli)
 
 ```
 slack <command> <subcommand> [flags]
 ```
 
-### Examples
+## Examples
 
 ```
 $ slack login   # Log in to your Slack account
@@ -22,7 +22,7 @@ $ slack run     # Start a local development server
 $ slack deploy  # Deploy to the Slack Platform
 ```
 
-### Options
+## Options
 
 ```
   -a, --app string           use a specific app ID or environment
@@ -37,7 +37,7 @@ $ slack deploy  # Deploy to the Slack Platform
   -v, --verbose              print debug logging and additional info
 ```
 
-### SEE ALSO
+## SEE ALSO
 
 * [slack activity](slack_activity)	 - Display the app activity logs from the Slack Platform
 * [slack app](slack_app)	 - Install, uninstall, and list teams with the app installed

docs/reference/commands/slack_activity.md

@@ -1,23 +1,23 @@
-## slack activity
+# `slack activity`
 
 Display the app activity logs from the Slack Platform
 
-### Synopsis
+## Synopsis
 
 Display the app activity logs from the Slack Platform
 
 ```
 slack activity [flags]
 ```
 
-### Examples
+## Examples
 
 ```
 $ slack platform activity     # Display app activity logs for an app
 $ slack platform activity -t  # Continuously poll for new activity logs
 ```
 
-### Options
+## Options
 
 ```
       --component string       component type to filter
@@ -40,7 +40,7 @@ $ slack platform activity -t  # Continuously poll for new activity logs
       --trace-id string        trace id to filter
 ```
 
-### Options inherited from parent commands
+## Options inherited from parent commands
 
 ```
   -a, --app string           use a specific app ID or environment
@@ -54,7 +54,7 @@ $ slack platform activity -t  # Continuously poll for new activity logs
   -v, --verbose              print debug logging and additional info
 ```
 
-### SEE ALSO
+## SEE ALSO
 
 * [slack](slack)	 - Slack command-line tool
 

docs/reference/commands/slack_app.md

@@ -1,32 +1,33 @@
-## slack app
+# `slack app`
 
 Install, uninstall, and list teams with the app installed
 
-### Synopsis
+## Synopsis
 
 Install, uninstall, and list teams with the app installed
 
 ```
 slack app [flags]
 ```
 
-### Examples
+## Examples
 
 ```
-$ slack install    # Install a production app to a team
-$ slack link       # Link an existing app to the project
-$ slack list       # List all teams with the app installed
-$ slack uninstall  # Uninstall an app from a team
-$ slack delete     # Delete an app and app info from a team
+$ slack app install    # Install a production app to a team
+$ slack app link       # Link an existing app to the project
+$ slack app list       # List all teams with the app installed
+$ slack app settings   # Open app settings in a web browser
+$ slack app uninstall  # Uninstall an app from a team
+$ slack app delete     # Delete an app and app info from a team
 ```
 
-### Options
+## Options
 
 ```
   -h, --help   help for app
 ```
 
-### Options inherited from parent commands
+## Options inherited from parent commands
 
 ```
   -a, --app string           use a specific app ID or environment
@@ -40,12 +41,13 @@ $ slack delete     # Delete an app and app info from a team
   -v, --verbose              print debug logging and additional info
 ```
 
-### SEE ALSO
+## SEE ALSO
 
 * [slack](slack)	 - Slack command-line tool
 * [slack app delete](slack_app_delete)	 - Delete the app
 * [slack app install](slack_app_install)	 - Install the app to a team
 * [slack app link](slack_app_link)	 - Add an existing app to the project
 * [slack app list](slack_app_list)	 - List teams with the app installed
+* [slack app settings](slack_app_settings)	 - Open app settings for configurations
 * [slack app uninstall](slack_app_uninstall)	 - Uninstall the app from a team
 

docs/reference/commands/slack_app_delete.md

@@ -1,16 +1,16 @@
-## slack app delete
+# `slack app delete`
 
 Delete the app
 
-### Synopsis
+## Synopsis
 
 Uninstall the app from the team and permanently delete the app and all of its data
 
 ```
 slack app delete [flags]
 ```
 
-### Examples
+## Examples
 
 ```
 # Delete an app and app info from a team
@@ -20,13 +20,13 @@ $ slack app delete
 $ slack app delete --team T0123456 --app local
 ```
 
-### Options
+## Options
 
 ```
   -h, --help   help for delete
 ```
 
-### Options inherited from parent commands
+## Options inherited from parent commands
 
 ```
   -a, --app string           use a specific app ID or environment
@@ -40,7 +40,7 @@ $ slack app delete --team T0123456 --app local
   -v, --verbose              print debug logging and additional info
 ```
 
-### SEE ALSO
+## SEE ALSO
 
 * [slack app](slack_app)	 - Install, uninstall, and list teams with the app installed
 

docs/reference/commands/slack_app_install.md

@@ -1,16 +1,16 @@
-## slack app install
+# `slack app install`
 
 Install the app to a team
 
-### Synopsis
+## Synopsis
 
 Install the app to a team
 
 ```
 slack app install [flags]
 ```
 
-### Examples
+## Examples
 
 ```
 $ slack app install                  # Install a production app to a team
@@ -19,15 +19,15 @@ $ slack app install                  # Install a production app to a team
 $ slack app install --team T0123456
 ```
 
-### Options
+## Options
 
 ```
   -h, --help                         help for install
       --org-workspace-grant string   grant access to a specific org workspace ID
                                        (or 'all' for all workspaces in the org)
 ```
 
-### Options inherited from parent commands
+## Options inherited from parent commands
 
 ```
   -a, --app string           use a specific app ID or environment
@@ -41,7 +41,7 @@ $ slack app install --team T0123456
   -v, --verbose              print debug logging and additional info
 ```
 
-### SEE ALSO
+## SEE ALSO
 
 * [slack app](slack_app)	 - Install, uninstall, and list teams with the app installed
 

docs/reference/commands/slack_app_link.md

@@ -1,8 +1,8 @@
-## slack app link
+# `slack app link`
 
 Add an existing app to the project
 
-### Synopsis
+## Synopsis
 
 Saves an existing app to a project to be available to other commands.
 
@@ -19,7 +19,7 @@ Only one app can exist for each combination of Team ID and environment.
 slack app link [flags]
 ```
 
-### Examples
+## Examples
 
 ```
 # Add an existing app to a project
@@ -29,14 +29,14 @@ $ slack app link
 $ slack app link --team T0123456789 --app A0123456789 --environment deployed
 ```
 
-### Options
+## Options
 
 ```
   -E, --environment string   environment to save existing app (local, deployed)
   -h, --help                 help for link
 ```
 
-### Options inherited from parent commands
+## Options inherited from parent commands
 
 ```
   -a, --app string           use a specific app ID or environment
@@ -50,7 +50,7 @@ $ slack app link --team T0123456789 --app A0123456789 --environment deployed
   -v, --verbose              print debug logging and additional info
 ```
 
-### SEE ALSO
+## SEE ALSO
 
 * [slack app](slack_app)	 - Install, uninstall, and list teams with the app installed
 

docs/reference/commands/slack_app_list.md

@@ -1,30 +1,30 @@
-## slack app list
+# `slack app list`
 
 List teams with the app installed
 
-### Synopsis
+## Synopsis
 
 List all teams that have installed the app
 
 ```
 slack app list [flags]
 ```
 
-### Examples
+## Examples
 
 ```
 $ slack app list  # List all teams with the app installed
 ```
 
-### Options
+## Options
 
 ```
       --all-org-workspace-grants   display all workspace grants for an app
                                    installed to an organization
   -h, --help                       help for list
 ```
 
-### Options inherited from parent commands
+## Options inherited from parent commands
 
 ```
   -a, --app string           use a specific app ID or environment
@@ -38,7 +38,7 @@ $ slack app list  # List all teams with the app installed
   -v, --verbose              print debug logging and additional info
 ```
 
-### SEE ALSO
+## SEE ALSO
 
 * [slack app](slack_app)	 - Install, uninstall, and list teams with the app installed
 

docs/reference/commands/slack_app_settings.md

@@ -0,0 +1,51 @@
+# `slack app settings`
+
+Open app settings for configurations
+
+## Synopsis
+
+Open app settings to configure an application in a web browser.
+
+Discovering new features and customizing an app manifest can be done from this
+web interface for apps with a "remote" manifest source.
+
+This command does not support apps deployed to Run on Slack infrastructure.
+
+```
+slack app settings [flags]
+```
+
+## Examples
+
+```
+# Open app settings for a prompted app
+$ slack app settings
+
+# Open app settings for a specific app
+$ slack app settings --app A0123456789
+```
+
+## Options
+
+```
+  -h, --help   help for settings
+```
+
+## Options inherited from parent commands
+
+```
+  -a, --app string           use a specific app ID or environment
+      --config-dir string    use a custom path for system config directory
+  -e, --experiment strings   use the experiment(s) in the command
+  -f, --force                ignore warnings and continue executing command
+      --no-color             remove styles and formatting from outputs
+  -s, --skip-update          skip checking for latest version of CLI
+  -w, --team string          select workspace or organization by team name or ID
+      --token string         set the access token associated with a team
+  -v, --verbose              print debug logging and additional info
+```
+
+## SEE ALSO
+
+* [slack app](slack_app)	 - Install, uninstall, and list teams with the app installed
+