Getting started: Content. Layout. Shape.

Author: amotl

docs/start/applications.md

@@ -0,0 +1,12 @@
+(sample-applications)=
+# Sample Applications
+
+::::{grid}
+
+:::{grid-item-card}
+:link: https://github.com/crate/crate-sample-apps
+A JavaScript guestbook app with a number of different backend implementations,
+each using a different client library to communicate with CrateDB. 
+:::
+
+::::

docs/start/connect.md

@@ -1,4 +1,5 @@
-# Connect to cluster
+(start-connect)=
+# Connect to CrateDB
 
 :::{include} /_include/links.md
 :::

docs/start/create.md

@@ -0,0 +1,57 @@
+---
+description: >-
+  This sections gives you some guidelines on how to get started quickly with
+  CrateDB.
+---
+(first-steps)=
+# First steps with CrateDB
+
+:::{div} sd-text-muted
+This section gives you some guidelines on how to get started quickly with CrateDB.
+:::
+
+## 1. Create your first cluster
+
+The fastest and easiest way to get started with CrateDB is by
+[creating a free CrateDB Cloud cluster][CrateDB Cloud Console].
+If you want to deploy CrateDB yourself, select the
+{ref}`on-premises <install>` or the {ref}`cloud-provider <install-cloud>`
+option. 
+
+## 2. Take a starter tutorial
+
+Go through the interactive tutorials that best match your interests,
+or run them interactively from the CrateDB Cloud UI.
+
+* **Working with JSON payloads?** • Analyze **marketing data**. • {{ '{}(#objects-basics)'.format(tutorial) }}
+
+  In this tutorial, explore the dynamic **OBJECT** data type to store and
+  query complex, nested, multi-structured data from various platforms.
+  You will also discover how to use generated columns to parse and manage
+  URLs for deeper insights.
+
+* **Interested in full-text search?** • Explore the **Netflix catalog**. • {{ '{}(#search-basics)'.format(tutorial) }}
+
+  In this tutorial, learn how to use CrateDB Cloud’s full-text search capabilities
+  to work with large datasets and manage a collection of Netflix titles.
+
+* **Exploring time-series data?** • Investigate **weather data**. • {{ '{}(#timeseries-querying)'.format(tutorial) }}
+
+  In this tutorial, you’ll work with weather readings from multiple locations
+  to learn how to efficiently store and analyze time-series datasets.
+
+## 3. Take an advanced tutorial
+
+* **Analyze Device Readings with Metadata Integration** • {{ '{}(#timeseries-objects)'.format(tutorial) }}
+  
+  In this tutorial, capture device metrics such as battery level, CPU usage,
+  and memory, then enrich your time-series data with metadata (JSON, text)
+  to enable more comprehensive analysis.
+
+**Congratulations!**\
+You’re now onboarded and ready to explore further. Check out the other sections in the menu to dive deeper into CrateDB’s capabilities.
+
+
+
+[check out our support plans]: https://cratedb.com/support/support-plans
+[CrateDB Cloud Console]: https://console.cratedb.cloud/

docs/start/first-steps.md

@@ -0,0 +1,110 @@
+(start-going-further)=
+# Going further
+
+To learn more about CrateDB, we invite you to explore the other sections
+of the documentation portal.
+
+:::::{card}
+
+::::{sd-table}
+:widths: 4 8
+
+:::{sd-row}
+```{sd-item} **Topic**
+```
+```{sd-item} **Description**
+```
+:::
+
+:::{sd-row}
+```{sd-item} Data modelling
+:class: sd-font-weight-bolder
+```
+```{sd-item}
+Learn the different types of structured, semi-structured, and unstructured data.
+```
+:::
+
+:::{sd-row}
+```{sd-item}
+:class: sd-font-weight-bolder
+{ref}`Query capabilities <query-capabilities>`
+```
+```{sd-item}
+Explore CrateDB’s key query capabilities, such as aggregations, ad-hoc queries,
+search and AI integration on large datasets at scale.
+```
+:::
+
+:::{sd-row}
+```{sd-item}
+:class: sd-font-weight-bolder
+{ref}`Drivers <connect>`
+```
+```{sd-item}
+Connect CrateDB to your applications using official drivers. Also explore CrateDB CLIs.
+```
+:::
+
+:::{sd-row}
+```{sd-item}
+:class: sd-font-weight-bolder sd-text-foreground
+{ref}`Integrations <integrate>`
+```
+```{sd-item}
+Use CrateDB with third-party adapters, connectors, data sources, and integrations.
+```
+:::
+
+:::{sd-row}
+```{sd-item}
+:class: sd-font-weight-bolder
+{ref}`Reference manual <crate-reference:index>`
+```
+```{sd-item}
+Access the complete technical reference manual for CrateDB, and learn about
+its concepts and details.
+```
+:::
+
+:::{sd-row}
+```{sd-item} Advanced guides
+:class: sd-font-weight-bolder
+```
+```{sd-item}
+Dive deeper into clustering concepts, reference architectures, installation, deployment, migration and upgrading.
+```
+:::
+
+:::{sd-row}
+```{sd-item} Sample applications
+:class: sd-font-weight-bolder
+```
+```{sd-item}
+Explore ready-to-run sample projects that demonstrate how to build real-world solutions using CrateDB.
+```
+:::
+
+:::{sd-row}
+```{sd-item}
+:class: sd-font-weight-bolder
+{ref}`Database management <administration>`
+```
+```{sd-item}
+Learn to manage your cluster with ease: configuration, sizing, performance tuning, cost optimization, monitoring and alerting, automation and REST API.
+```
+:::
+
+:::{sd-row}
+```{sd-item}
+:class: sd-font-weight-bolder
+[Support and learning](https://learn.cratedb.com/)
+```
+```{sd-item}
+Get access to more resources to continue learning.
+```
+:::
+
+::::
+
+:::::

docs/start/going-further.md

@@ -5,18 +5,21 @@
 ```{toctree}
 :maxdepth: 1
 
-create
+first-steps
 connect
-schema
+going-further
+query/index
+applications
 Ingesting data <../ingest/index>
-query
 ```
 
 
 :::{note}
 To learn more about all the details of CrateDB features, operations, and
-its SQL dialect, please also visit the [CrateDB Reference Manual].
+its SQL dialect, please also visit the [All Features] page and the
+[CrateDB Reference Manual].
 :::
 
 
+[All Features]: project:#features
 [CrateDB Reference Manual]: inv:crate-reference:*:label#index