Getting started: Rework whole section

Author: amotl

docs/_include/links.md

@@ -1,6 +1,7 @@
 <!-- markdownlint-disable MD034 -->
 <!-- markdownlint-disable MD053 -->
 
+[Admin UI]: inv:crate-admin-ui:*:label#index
 [Amazon DynamoDB Streams]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Streams.html
 [Amazon Kinesis Data Streams]: https://docs.aws.amazon.com/streams/latest/dev/introduction.html
 [Apache Airflow]: https://airflow.apache.org/
@@ -13,8 +14,9 @@
 [cloud-datashader-github]: https://github.com/crate/cratedb-examples/blob/amo/cloud-datashader/topic/timeseries/explore/cloud-datashader.ipynb
 [CTE]: inv:crate-reference#sql_dql_with
 [CrateDB BLOBs]: inv:crate-reference:*:label#blob_support
-[CrateDB Cloud]: https://cratedb.com/product/cloud
+[CrateDB Cloud]: inv:cloud:*:label#index
 [CrateDB JDBC Driver]: https://cratedb.com/docs/jdbc/
+[CrateDB Reference Manual]: inv:crate-reference:*:label#index
 [CrateDB Self-Managed]: https://cratedb.com/product/self-managed
 [CrateDB's PostgreSQL interface]: inv:crate-reference#interface-postgresql
 [crate-jdbc-standalone]: https://repo1.maven.org/maven2/io/crate/crate-jdbc-standalone/

docs/index.md

@@ -307,9 +307,9 @@ Selected application domains where others are using CrateDB successfully.
 ```{toctree}
 :hidden:
 
+start/index
 install/index
 connect/index
-getting-started
 feature/index
 Ingestion <ingest/index>
 topic/index

docs/getting-started.md renamed to docs/start/connect.md

@@ -1,21 +1,18 @@
-(use)=
-(getting-started)=
+# Connect to cluster
 
-# Getting Started
-
-
-{#introduction}
-## Introduction
+:::{include} /_include/links.md
+:::
 
-Once CrateDB is [installed and running](#install), you can start to interact
+Once CrateDB is {ref}`installed and running <install>`, you can start to interact
 with the database for the first time.
 
 
 {#use-admin-ui}
-### The Admin UI
-
+## Admin UI
+:::{div}
 CrateDB ships with a browser-based administration interface called
-[Admin UI](inv:crate-admin-ui:*:label#index).
+[Admin UI].
+:::
 It is enabled on each CrateDB node, you can use it to inspect and
 interact with the whole CrateDB cluster in a number of ways.
 
@@ -36,28 +33,21 @@ a dedicated user account for accessing the Admin UI. See [](#create-user).
 
 
 {#use-crash}
-### The CrateDB Shell
+## CrateDB Shell
 
 The CrateDB Shell, called `crash`, is an interactive command-line interface
 (CLI) program for working with CrateDB on your favorite terminal. To learn more
-about it, please refer to its documentation at [](inv:crate-crash:*:label#index).
+about it, please refer to its documentation at {ref}`crate-crash:index`.
 
 ![image](https://cratedb.com/docs/crate/crash/en/latest/_images/query.png){width=320px}
 
 
 {#use-dive-in}
 {#use-start-building}
-## How to Connect
-There is a dedicated page which enumerates all the connectivity options.
+## Adapters and drivers
+:::{div}
+- To learn how to connect to CrateDB using software drivers, see {ref}`connect`.
 
-- {ref}`connect`
-
-
-:::{tip}
-To learn more about all the details of CrateDB features, operations, and
-its SQL dialect, please also visit the [CrateDB Reference Manual].
+- To learn more about all the details of CrateDB features, operations, and
+  its SQL dialect, please also visit the [CrateDB Reference Manual].
 :::
-
-
-[CrateDB Cloud]: inv:cloud:*:label#index
-[CrateDB Reference Manual]: inv:crate-reference:*:label#index

docs/start/create.md

@@ -0,0 +1,24 @@
+# Create a cluster
+
+:::{rubric} CrateDB Cloud
+:::
+
+The fastest and easy way is to create a [CrateDB Cloud cluster][CrateDB Cloud Console].
+See also documentation about {ref}`creating a new cluster in CrateDB Cloud <cloud:quick-start>`.
+A free tier is available.
+
+Basic support is included. If you need premium support, please [check out our support plans].
+
+:::{rubric} CrateDB Self-Deployed
+:::
+
+If you want to deploy CrateDB yourself, select the deployment model below:
+
+* Deploy on-premises or locally: {ref}`install`
+* Deploy on your own Cloud: {ref}`install-cloud`
+
+For support, please [check out our support plans].
+
+
+[check out our support plans]: https://cratedb.com/support/support-plans
+[CrateDB Cloud Console]: https://console.cratedb.cloud/

docs/start/index.md

@@ -0,0 +1,22 @@
+(use)=
+(getting-started)=
+# Getting Started
+
+```{toctree}
+:maxdepth: 1
+
+create
+connect
+schema
+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].
+:::
+
+
+[CrateDB Reference Manual]: inv:crate-reference:*:label#index

docs/start/query.md

@@ -0,0 +1,14 @@
+# Querying data
+
+SQL is the most widely used language for querying data and is the natural
+choice for people in many roles working with data in databases.
+
+CrateDB extends industry-standard SQL with functionalities to support its
+data types, data I/O procedures, and cluster management.
+
+To learn more, check out the {ref}`SQL syntax reference manual <crate-reference:sql>`.
+
+
+:::{note}
+🚧 _Please note this page is a work in progress._ 🚧
+:::

docs/start/schema.md

@@ -0,0 +1,23 @@
+# Create table schema
+
+In CrateDB, create a table within a schema using a fully qualified name:
+```sql
+CREATE TABLE schema_name.table_name (
+  id INTEGER PRIMARY KEY,
+  name TEXT
+);
+```
+
+Also, you can grant rights like so on a schema (even if it doesn’t explicitly exist yet):
+```sql
+GRANT DQL ON SCHEMA schema_name TO user_name;
+```
+
+In CrateDB, schemas are just namespaces that are created and dropped implicitly.
+Therefore, when `GRANT`, `DENY` or `REVOKE` are invoked on a schema level,
+CrateDB takes the schema name provided without further validation.
+
+
+:::{note}
+🚧 _Please note this page is a work in progress._ 🚧
+:::