docs: Restructure quick-start guide into separate end-to-end guides for clp-json and clp-text. (#968)

Co-authored-by: Devin Gibson <[email protected]>
Co-authored-by: kirkrodrigues <[email protected]>

Author: 3 people

docs/src/user-guide/quick-start-cluster-setup/multi-node.md renamed to docs/src/user-guide/guides-multi-node.md

@@ -110,8 +110,26 @@ Where `<component>` is the name of the component in the groups above.
 
 ## Using CLP
 
-Check out the [compression](../quick-start-compression/index) and
-[search](../quick-start-search/index) guides to compress and search your logs.
+To learn how to compress and search your logs, check out the quick-start guide that corresponds to
+the flavor of CLP you're running:
+
+::::{grid} 1 1 2 2
+:gutter: 2
+
+:::{grid-item-card}
+:link: quick-start/clp-json
+Using clp-json
+^^^
+How to compress and search JSON logs.
+:::
+
+:::{grid-item-card}
+:link: quick-start/clp-text
+Using clp-text
+^^^
+How to compress and search unstructured text logs.
+:::
+::::
 
 ## Stopping CLP
 

docs/src/user-guide/guides-overview.md

@@ -11,4 +11,11 @@ Using object storage
 ^^^
 Using CLP to ingest logs from object storage and store archives on object storage.
 :::
+
+:::{grid-item-card}
+:link: guides-multi-node
+Multi-node deployment
+^^^
+How to deploy CLP across multiple nodes.
+:::
 ::::

docs/src/user-guide/guides-using-object-storage/clp-usage.md

@@ -1,7 +1,7 @@
 # Using CLP with object storage
 
 To compress logs from S3, follow the steps in the section below. For all other operations, you
-should be able to use CLP as described in the [quick start](../quick-start-overview.md) guide.
+should be able to use CLP as described in the [clp-json quick-start guide](../quick-start/clp-json).
 
 ## Compressing logs from S3
 

docs/src/user-guide/guides-using-object-storage/index.md

@@ -11,8 +11,8 @@ to use object storage for any combination of the three use cases (e.g., compress
 cache the stream files on S3, but store archives on the local filesystem).
 
 :::{note}
-Currently, only the [clp-json][release-choices] release supports object storage. Support for
-`clp-text` will be added in a future release.
+Currently, only [clp-json][release-choices] supports object storage. Support for `clp-text` will be
+added in a future release.
 :::
 
 :::{note}
@@ -22,8 +22,8 @@ will be added in a future release.
 
 ## Prerequisites
 
-1. This guide assumes you're able to configure, start, stop, and use a CLP cluster as described in
-   the [quick-start guide](../quick-start-overview.md).
+1. This guide assumes you're able to configure, start, stop, and use CLP as described in the
+   [clp-json quick-start guide](../quick-start/clp-json.md).
 2. An S3 bucket and [key prefix][aws-key-prefixes] containing the logs you wish to compress.
 3. An S3 bucket and key prefix where you wish to store compressed archives.
 4. An S3 bucket and key prefix where you wish to cache stream files.
@@ -136,4 +136,4 @@ clp-usage
 [aws-iam-roles]: https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-role.html
 [aws-key-prefixes]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html
 [aws-sts-credentials]: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html
-[release-choices]: ../quick-start-cluster-setup/index.md#choosing-a-release
+[release-choices]: ../quick-start/index.md#choosing-a-flavor

docs/src/user-guide/index.md

@@ -9,17 +9,18 @@ The sections are as follows:
 :gutter: 2
 
 :::{grid-item-card}
-:link: quick-start-overview
+:link: quick-start/index
 Quick start
 ^^^
-A quick start guide for setting up a CLP cluster, compressing your logs, and searching them.
+A quick-start guide for choosing a flavor of CLP, setting it up, compressing your logs, and
+searching them.
 :::
 
 :::{grid-item-card}
 :link: guides-overview
 Guides
 ^^^
-Guides for using CLP in a variety of use cases.
+Guides for using CLP in various use cases.
 :::
 
 :::{grid-item-card}
@@ -48,10 +49,9 @@ Reference docs like format specifications, etc.
 :hidden:
 :caption: Quick start
 
-quick-start-overview
-quick-start-cluster-setup/index
-quick-start-compression/index
-quick-start-search/index
+quick-start/index
+quick-start/clp-json
+quick-start/clp-text
 :::
 
 :::{toctree}
@@ -61,6 +61,7 @@ quick-start-search/index
 
 guides-overview
 guides-using-object-storage/index
+guides-multi-node
 :::
 
 :::{toctree}