Refactoring / Naming things: Implement suggestions by CodeRabbit

Author: amotl

docs/index.md

@@ -72,24 +72,11 @@ Guides and tutorials about how to use CrateDB and CrateDB Cloud in practice.
 ::::
 
 
-:::{card} Introduction
-:link: all-features
-:link-type: ref
+## Features
 
-CrateDB is a distributed and scalable SQL database for storing and analyzing
-massive amounts of data in near real-time, even with complex queries. It is
-based on Lucene, combines a unique set of features, and is PostgreSQL-compatible.
-
-![](https://cratedb.com/hs-fs/hubfs/nativesql.png?width=800&name=nativesql.png)
-+++
-Read about all features of CrateDB at a glance.
+:::{rubric} Highlights
 :::
 
-
-## Feature Highlights
-
-A few selected features.
-
 ::::{grid} 1 2 3 3
 :padding: 0
 
@@ -134,8 +121,21 @@ A few selected features.
 
 ::::
 
+:::{card} All features
+:link: all-features
+:link-type: ref
 
-## Data Ingestion
+CrateDB is a distributed and scalable SQL database for storing and analyzing
+massive amounts of data in near real-time, even with complex queries. It is
+based on Lucene, combines a unique set of features, and is PostgreSQL-compatible.
+
+![](https://cratedb.com/hs-fs/hubfs/nativesql.png?width=800&name=nativesql.png)
++++
+Read about all features of CrateDB at a glance.
+:::
+
+
+## Data ingestion
 
 Load data into CrateDB.
 
@@ -184,6 +184,29 @@ Load data into CrateDB.
 ::::
 
 
+## Solutions
+
+Learn how others are using CrateDB successfully.
+
+::::{grid} 1 2 3 3
+:padding: 0
+
+:::{grid-item-card} Solutions and use cases
+:link: solutions
+:link-type: ref
+:link-alt: Solutions built with CrateDB
+:padding: 1
+:text-align: center
+:class-card: sd-pt-3
+:class-body: sd-fs-1
+:class-title: sd-fs-5
+
+{material-outlined}`lightbulb;1.3em`
+:::
+
+::::
+
+
 ## Topics
 
 Learn how to apply CrateDB's features to optimally cover use-cases across different
@@ -266,43 +289,6 @@ software applications, libraries, and frameworks.
 ::::
 
 
-## Use Cases
-
-Selected application domains where others are using CrateDB successfully.
-
-::::{grid} 1 2 3 3
-:padding: 0
-
-
-:::{grid-item-card} Raw-Data Analytics
-:link: analytics
-:link-type: ref
-:link-alt: CrateDB in tracking and analytics scenarios
-:padding: 3
-:text-align: center
-:class-card: sd-pt-3
-:class-body: sd-fs-1
-:class-title: sd-fs-5
-
-{material-outlined}`analytics;1.3em`
-:::
-
-:::{grid-item-card} Industrial Data
-:link: industrial
-:link-type: ref
-:link-alt: CrateDB in industrial / IIoT / Industry 4.0 scenarios
-:padding: 3
-:text-align: center
-:class-card: sd-pt-3
-:class-body: sd-fs-1
-:class-title: sd-fs-5
-
-{material-outlined}`precision_manufacturing;1.3em`
-:::
-
-::::
-
-
 
 ```{toctree}
 :hidden:

docs/ingest/telemetry/index.md

@@ -16,9 +16,9 @@
 
 CrateDB works well for storing massive amounts of telemetry data, such as metrics and logs.
 
-It is a spiritual successor, or alternative to, rrdtool, Graphite, InfluxDB, Prometheus,
-Mimir, or Thanos, but with the benefits of long term storage capabilities, standard
-database interfaces, SQL query language, and horizontal scalability as you go.
+CrateDB can serve as an alternative to tools like rrdtool, Graphite, InfluxDB,
+Prometheus, Mimir, or Thanos, while adding long‑term storage, standard database
+interfaces, SQL, and horizontal scalability.
 
 CrateDB integrates with metrics collection agents, brokers, and stores.
 This documentation section lists applications and daemons which can
@@ -53,14 +53,14 @@ scenarios. CrateDB offers corresponding integration adapters.
 :gutter: 2
 
 ::::{grid-item-card} Prometheus
-:link: fulltext-search
+:link: prometheus
 :link-type: ref
 Prometheus is an open-source systems monitoring and alerting toolkit
 for collecting metrics data from applications and infrastructures.
 ::::
 
 ::::{grid-item-card} Telegraf
-:link: geo-search
+:link: telegraf
 :link-type: ref
 Telegraf is a leading open source server agent to help you collect metrics
 from your stacks, sensors, and systems.

docs/solution/index.md

@@ -1,4 +1,5 @@
 (use-cases)=
+(solutions)=
 # Solutions and use cases
 
 CrateDB is being developed in an open-source spirit, and closely together
@@ -12,7 +13,7 @@ build real-time data management and analytics solutions and platforms.
 :gutter: 2
 
 
-:::{grid-item-card} {material-outlined}`search;2em` Fulltext and semantic search
+:::{grid-item-card} {material-outlined}`search;2em` Full-text and semantic search
 :link: search-overview
 :link-type: ref
 :link-alt: About CrateDB's search features

docs/solution/industrial/index.md

@@ -147,9 +147,9 @@ ensure real-time production quality control.
 CrateDB helps Rauch to identify and predict production issues and gives access
 to production data for many years, with no need for additional infrastructure.
 
-Rauch is filling 33 cans per second and how that adds up to 400 data records
-per second which are being processed, stored, and analyzed. In total, they are
-within the range of one to ten billion records persisted in CrateDB.
+Rauch fills 33 cans per second, which adds up to 400 data records per second
+that are processed, stored, and analyzed. In total, they are within the range
+of one to ten billion records persisted in CrateDB.
 
 - [Rauch: High-Speed Production Lines]