You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@iceberg.apache.org by cw...@apache.org on 2021/08/17 23:03:39 UTC
[iceberg] branch master updated: Doc: refactor engines pages and
add link to PrestoDB (#2842)
This is an automated email from the ASF dual-hosted git repository.
cws pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/iceberg.git
The following commit(s) were added to refs/heads/master by this push:
new a0e4056 Doc: refactor engines pages and add link to PrestoDB (#2842)
a0e4056 is described below
commit a0e4056550368dbac7c6d6e63eab76037c1b6289
Author: Jack Ye <yz...@amazon.com>
AuthorDate: Tue Aug 17 16:03:31 2021 -0700
Doc: refactor engines pages and add link to PrestoDB (#2842)
* Doc: refactor engines pages and add link to PrestoDB
* address comments
---
site/docs/getting-started.md | 8 ++++++--
site/docs/index.md | 3 +--
site/docs/{trino.md => trino-prestodb.md} | 9 ++++++++-
site/mkdocs.yml | 29 ++++++++++++++++-------------
4 files changed, 31 insertions(+), 18 deletions(-)
diff --git a/site/docs/getting-started.md b/site/docs/getting-started.md
index e496bb6..df3ad51 100644
--- a/site/docs/getting-started.md
+++ b/site/docs/getting-started.md
@@ -17,10 +17,14 @@
# Getting Started
-## Using Iceberg in Spark 3
-
The latest version of Iceberg is [{{ versions.iceberg }}](./releases.md).
+Spark is currently the most feature-rich compute engine for Iceberg operations.
+We recommend you to get started with Spark to understand Iceberg concepts and features with examples.
+You can also view documentations of using Iceberg with other compute engine under the **Engines** tab.
+
+## Using Iceberg in Spark 3
+
To use Iceberg in a Spark shell, use the `--packages` option:
```sh
diff --git a/site/docs/index.md b/site/docs/index.md
index 3403f88..0c76bae 100644
--- a/site/docs/index.md
+++ b/site/docs/index.md
@@ -20,8 +20,7 @@
# 
-**Apache Iceberg is an open table format for huge analytic datasets.** Iceberg adds tables to Trino and Spark that use a high-performance format that works just like a SQL table.
-
+**Apache Iceberg is an open table format for huge analytic datasets.** Iceberg adds tables to compute engines including Spark, Trino, PrestoDB, Flink and Hive using a high-performance table format that works just like a SQL table.
### User experience
diff --git a/site/docs/trino.md b/site/docs/trino-prestodb.md
similarity index 56%
rename from site/docs/trino.md
rename to site/docs/trino-prestodb.md
index 395dbf9..fac731a 100644
--- a/site/docs/trino.md
+++ b/site/docs/trino-prestodb.md
@@ -17,4 +17,11 @@
# Trino (formerly Presto SQL)
-The Iceberg connector is available with Trino. It is feature complete and usage details can be found in the [documentation](https://trino.io/docs/current/connector/iceberg.html)
+The Iceberg connector is available with PrestoSQL, which is rebranded as Trino since January 2021.
+This page is kept for backwards compatibility only.
+The documentation for Iceberg's Trino connector has moved to the Trino website. Please consult the [Iceberg section](https://trino.io/docs/current/connector/iceberg.html) of the Trino docs for more information.
+
+# PrestoDB
+
+The Presto trademark is now exclusively reserved for PrestoDB.
+The documentation for Iceberg's PrestoDB connector is in the PrestoDB website. Please consult the [Iceberg section](https://prestodb.io/docs/current/connector/iceberg.html) of the PrestoDB docs for more information.
diff --git a/site/mkdocs.yml b/site/mkdocs.yml
index e9a8972..7a424e5 100644
--- a/site/mkdocs.yml
+++ b/site/mkdocs.yml
@@ -36,7 +36,7 @@ plugins:
- redirects:
redirect_maps:
'time-travel.md': 'spark-queries/#time-travel'
- 'presto.md': 'trino.md'
+ 'presto.md': 'trino-prestodb.md'
- markdownextradata
markdown_extensions:
- toc:
@@ -56,6 +56,7 @@ nav:
- Trademarks: trademarks.md
- How to Release: how-to-release.md
- Security: security.md
+ - Getting Started: getting-started.md
- Tables:
- Configuration: configuration.md
- Schemas: schemas.md
@@ -64,18 +65,20 @@ nav:
- Maintenance: maintenance.md
- Performance: performance.md
- Reliability: reliability.md
- - Spark:
- - Getting Started: getting-started.md
- - Configuration: spark-configuration.md
- - DDL: spark-ddl.md
- - Queries: spark-queries.md
- - Writes: spark-writes.md
- - Maintenance Procedures: spark-procedures.md
- - Structured Streaming: spark-structured-streaming.md
- - Time Travel: spark-queries/#time-travel
- - Trino: https://trino.io/docs/current/connector/iceberg.html
- - Flink: flink.md
- - Hive: hive.md
+ - Engines:
+ - Spark:
+ - Getting Started: getting-started.md
+ - Configuration: spark-configuration.md
+ - DDL: spark-ddl.md
+ - Queries: spark-queries.md
+ - Writes: spark-writes.md
+ - Maintenance Procedures: spark-procedures.md
+ - Structured Streaming: spark-structured-streaming.md
+ - Time Travel: spark-queries/#time-travel
+ - Flink: flink.md
+ - Hive: hive.md
+ - Trino: https://trino.io/docs/current/connector/iceberg.html
+ - PrestoDB: https://prestodb.io/docs/current/connector/iceberg.html
- Integrations:
- AWS: aws.md
- Nessie: nessie.md