trailing-space

Author: mendonk

docs-src/astra-cli-core/modules/ROOT/pages/getting-started.adoc

@@ -4,9 +4,9 @@ Read this topic to learn how to get started with {astra_cli}.
 
 == Setup
 
-Before issuing CLI `astra` commands, initialize the configuration file `~/.astrarc`. 
-Run the following command. 
-You will be asked to provide your token, which begins with `AstraCS:\...`. 
+Before issuing CLI `astra` commands, initialize the configuration file `~/.astrarc`.
+Run the following command.
+You will be asked to provide your token, which begins with `AstraCS:\...`.
 The token will be saved so that you're authorized to run the CLI commands.
 
 [source,bash]

docs-src/astra-cli-core/modules/ROOT/pages/index.adoc

@@ -1,92 +1,61 @@
-= Astra CLI
+= {astra_cli} Landing Page
 :page-layout: gcx-landing
 :data-uri:
 
-== Getting started with {astra_cli}
+The DataStax Astra Command-Line Interface ({astra_cli}) is a set of commands used to create and manage Astra resources.
+{astra_cli} is available across Astra services and is designed to get you working quickly with {astra_db} and {astra_stream}, with an emphasis on automation.
 
-++++
-<div class="landing-row">
-++++
+{astra_cli} makes it possible to submit commands instead of *or in addition to* using {astra_ui} and DataStax API calls.
 
-[sidebar.landing-card]
-.Create your first thing
-****
---
-You can do amazing things with {astra_cli}.
+{astra_cli} features are for operators, Site Reliability Engineers (SREs), and developers who want the option of using commands when working with {astra_db} databases and {astra_stream} tenants.
+The tools should be complementary and not restrictive, so choose what tool works best for you.
 
-* Create a thing.
-* Create a more advanced thing.
---
-[.landing-card-body-icon]
-image::what-is-astra-db.svg[icon description,40]
-****
+{astra_cli} is free.
 
-++++
-</div>
-++++
+Any user with the **Organization Administrator** role may use {astra_cli} commands with:
+
+* {astra_db} Serverless databases
+* {astra_db} Classic databases
+* {astra_stream} tenants
+
+Get started with the links below.
 
 ++++
 <div class="landing-row">
 ++++
 
 [sidebar.landing-card]
-.Another thing
+.Install and get started
 ****
 --
-More things to do with {astra_cli}.
+* xref:installation.adoc[Install {astra_cli}]
+* xref:getting-started.adoc[Get started]
 --
 [.landing-card-body-icon]
 image::create-db-now.svg[icon description,40]
 ****
 
 [sidebar.landing-card]
-.Another thing
+.Manage {astra_db}
 ****
 --
-More things to do with {astra_cli}.
+* xref:managing.adoc[]
+*
 --
 [.landing-card-body-icon]
 image::what-is-astra-streaming.svg[icon description,40]
 ****
 
 [sidebar.landing-card]
-.Another thing
+.Manage {astra_stream}
 ****
 --
-More things to do with {astra_cli}.
+* xref:astra-streaming-cli.adoc[]
 --
 [.landing-card-body-icon]
 image::what-is-stargate-api.svg[icon description,40]
 ****
 
 ++++
 </div>
-++++
-
-++++
-<div class="landing-row">
-++++
-
-[sidebar.landing-card]
-.Another thing
-****
---
-More things to do with {astra_cli}.
---
-[.landing-card-body-icon]
-image::what-is-k8ssandra.svg[icon description,40]
-****
-
-[sidebar.landing-card]
-.Another thing
-****
---
-More things to do with {astra_cli}.
---
-[.landing-card-body-icon]
-image::what-is-datastax-luna.svg[Luna card icon,40]
-****
-
-++++
-</div>
-++++
+++++

docs-src/astra-cli-core/modules/ROOT/pages/installation.adoc

@@ -6,17 +6,17 @@ The GitHub repo for {astra_cli} is https://github.com/datastax/astra-cli[here^].
 
 * For information about the latest release, see https://github.com/datastax/astra-cli/releases[this page].
 
-* If installed previously, run `astra --version` to find your installed version and see if you need to update. 
+* If installed previously, run `astra --version` to find your installed version and see if you need to update.
 
 == Install {astra_cli} on macOS
 
 You can install via Homebrew or manually.
 
 === Using Homebrew
 
-Homebrew is the easiest way to manage your {astra_cli} install. 
-Homebrew provides convenient ways to install, update, and uninstall. 
-If you don't have Homebrew available on your system, install https://brew.sh/[Homebrew^] before continuing. 
+Homebrew is the easiest way to manage your {astra_cli} install.
+Homebrew provides convenient ways to install, update, and uninstall.
+If you don't have Homebrew available on your system, install https://brew.sh/[Homebrew^] before continuing.
 
 You can install {astra_cli} on macOS by updating your brew repository information, and then running the install command:
 
@@ -25,7 +25,7 @@ You can install {astra_cli} on macOS by updating your brew repository informatio
 brew install datastax/astra-cli/astra-cli
 ----
 
-The Homebrew formula of {astra_cli} installs a completion file named `astra` in the Homebrew-managed completions directory. 
+The Homebrew formula of {astra_cli} installs a completion file named `astra` in the Homebrew-managed completions directory.
 By default, the location is `/usr/local/etc/bash_completion.d/`.
 
 To enable completion, please follow Homebrew's instructions https://docs.brew.sh/Shell-Completion[here^].

docs-src/astra-cli-core/modules/ROOT/pages/managing.adoc

@@ -18,7 +18,7 @@ Use the following {astra_cli} commands to manage your {astra_db} databases. From
 
 == Create a database
 
-You can create an {astra_db} Serverless or {astra_db} Classic database with the `astra db create <db-name>` command. 
+You can create an {astra_db} Serverless or {astra_db} Classic database with the `astra db create <db-name>` command.
 
 Example:
 
@@ -45,7 +45,7 @@ The database name itself does not ensure uniqueness within your {astra_db} organ
 
 To change this behavior, use the `--if-not-exist` option.
 
-Database creation is asynchronous operation. 
+Database creation is asynchronous operation.
 Still during your CI/CD you want the database to be in an `ACTIVE` state before moving forward.
 Using the option `--wait` will trigger a blocking command until the database is ready.
 
@@ -56,7 +56,7 @@ Example:
 astra db create demo -k ks2 --if-not-exist --wait
 ----
 
-If you are using the Free plan, after a period of inactivity (23 hours) the database moves to a `HIBERNATED` state. 
+If you are using the Free plan, after a period of inactivity (23 hours) the database moves to a `HIBERNATED` state.
 You can use the `astra db resume <db-name>` command to reactivate the database.
 
 
@@ -96,7 +96,7 @@ Sample output:
  +---------------------+--------------------------------------+---------------------+----------------+
 ----
 
-You can also change the database list's output type with the `astra db list -o <type>` command, where <type> can be `csv` or `json`. 
+You can also change the database list's output type with the `astra db list -o <type>` command, where <type> can be `csv` or `json`.
 
 Examples:
 
@@ -359,7 +359,7 @@ To get a special property, add the option `--key` and its type.
 
 Multiple key types are available: `id`, `status`, `cloud`, `keyspace`, `keyspaces`, `region`, `regions`.
 
-Notice that the output is raw. This command is expected to be used in scripts. 
+Notice that the output is raw. This command is expected to be used in scripts.
 
 Example:
 
@@ -428,7 +428,7 @@ astra help db list-keyspaces
 
 === Create a new keyspace
 
-To add a keyspace named `ks2` to an existing database named `demo`, use the following command. 
+To add a keyspace named `ks2` to an existing database named `demo`, use the following command.
 The option `--if-not-exist` is optional but could help you provide idempotent scripts. Example:
 
 [source,bash]
@@ -447,7 +447,7 @@ astra db list-keyspaces demo
 
 == Use cqlsh
 
-https://cassandra.apache.org/doc/latest/cassandra/tools/cqlsh.html[cqlsh^] is a standalone shell to work with Apache Cassandra&reg;. 
+https://cassandra.apache.org/doc/latest/cassandra/tools/cqlsh.html[cqlsh^] is a standalone shell to work with Apache Cassandra&reg;.
 It is compliant with {astra_cli} but requires a few extra steps of configuration.
 The purpose of {astra_cli} is to integrate with `cqlsh` and do the integration for you.
 
@@ -500,7 +500,7 @@ astra db cqlsh demo -f sample.cql
 
 == Use DSBulk with {astra_cli} to load, unload, and count data
 
-https://github.com/datastax/dsbulk[DataStax Bulk Loader^] (`dsbulk`) allows you to you load, unload, and count data from Cassandra-based database tables, such as those in Apache Cassandra, DataStax Enterprise, and Astra DB. {astra_cli} commands can invoke dsbulk. 
+https://github.com/datastax/dsbulk[DataStax Bulk Loader^] (`dsbulk`) allows you to you load, unload, and count data from Cassandra-based database tables, such as those in Apache Cassandra, DataStax Enterprise, and Astra DB. {astra_cli} commands can invoke dsbulk.
 
 As for `cqlsh`, {astra_cli} will *download*, *install*, *setup* and *wrap* the `dsbulk` command for you.
 All options are available.
@@ -552,14 +552,14 @@ quit
 
 [source,bash]
 ----
-astra db load demo \   
- -url https://raw.githubusercontent.com/awesome-astra/docs/main/docs/assets/cities.csv \   
- -k demo \   
- -t cities_by_country \   
+astra db load demo \
+ -url https://raw.githubusercontent.com/awesome-astra/docs/main/docs/assets/cities.csv \
+ -k demo \
+ -t cities_by_country \
  --schema.allowMissingFields true
----- 
+----
 
-The first time you run the `astra db load` command, the message -- `DSBulk is starting please wait` -- may take a few seconds to appear because  
+The first time you run the `astra db load` command, the message -- `DSBulk is starting please wait` -- may take a few seconds to appear because
 {astra_cli} is downloading `dsbulk` (if it wasn't downloaded previously).
 
 Sample output:
@@ -724,7 +724,7 @@ Sample output:
 
 == Resume a hibernated database
 
-If you are using the {astra_db} Free plan, your database will be hibernated (inactive) after 23 hours of inactivity. (This behavior does not occur when you upgrade to a paid {astra_db} plan.) 
+If you are using the {astra_db} Free plan, your database will be hibernated (inactive) after 23 hours of inactivity. (This behavior does not occur when you upgrade to a paid {astra_db} plan.)
 
 To wake up the database, you can use the `astra db resume` command.
 
@@ -740,9 +740,9 @@ Sample output:
 [source,bash]
 ----
 +---------------------+--------------------------------------+---------------------+----------------+
-| Name                | id                                   | Default Region      | Status         | 
-+---------------------+--------------------------------------+---------------------+----------------+ 
-| mydatabase          | 643c6bb8-2336-4649-97d5-999999999999 | eu-central-1        | HIBERNATED     | 
+| Name                | id                                   | Default Region      | Status         |
++---------------------+--------------------------------------+---------------------+----------------+
+| mydatabase          | 643c6bb8-2336-4649-97d5-999999999999 | eu-central-1        | HIBERNATED     |
 +---------------------+--------------------------------------+---------------------+----------------+
 ----
 
@@ -799,7 +799,7 @@ Here we'll name a configuration `dev` and identify the auth token of a separate
 astra config create dev --token <token_of_org_2>
 ----
 
-=== Use your section configuration 
+=== Use your section configuration
 
 You can use an organization configuration anytime by qualifying the `astra` command with the `--config <config_name>` option.
 
@@ -828,7 +828,7 @@ astra config list
 
 === Delete a section
 
-You can delete any organization. 
+You can delete any organization.
 If you delete the selected organization, you will have to pick a new one.
 
 Delete your config:
@@ -847,4 +847,4 @@ astra config list
 
 
 // == What's next?
-// See the CLI commands that you can use with DataStax {astra_stream} Pulsar tenants. ( TODO: link ) 
+// See the CLI commands that you can use with DataStax {astra_stream} Pulsar tenants. ( TODO: link )