apache · rdblue · Jun 23, 2022 · Jun 22, 2022 · Jun 23, 2022 · Jun 23, 2022
diff --git a/docs/_index.md b/docs/_index.md
@@ -0,0 +1,55 @@
+---
+title: "Introduction"
+menu: main
+weight: 0
+---
+<!--
+ - Licensed to the Apache Software Foundation (ASF) under one or more
+ - contributor license agreements.  See the NOTICE file distributed with
+ - this work for additional information regarding copyright ownership.
+ - The ASF licenses this file to You under the Apache License, Version 2.0
+ - (the "License"); you may not use this file except in compliance with
+ - the License.  You may obtain a copy of the License at
+ -
+ -   http://www.apache.org/licenses/LICENSE-2.0
+ -
+ - Unless required by applicable law or agreed to in writing, software
+ - distributed under the License is distributed on an "AS IS" BASIS,
+ - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ - See the License for the specific language governing permissions and
+ - limitations under the License.
+ -->
+
+![Iceberg](./img/Iceberg-logo.png)
+
+**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
+
+Iceberg avoids unpleasant surprises. Schema evolution works and won't inadvertently un-delete data. Users don't need to know about partitioning to get fast queries.
+
+* [Schema evolution](evolution#schema-evolution) supports add, drop, update, or rename, and has [no side-effects](evolution#correctness)
+* [Hidden partitioning](partitioning) prevents user mistakes that cause silently incorrect results or extremely slow queries
+* [Partition layout evolution](evolution#partition-evolution) can update the layout of a table as data volume or query patterns change
+* [Time travel](spark-queries#time-travel) enables reproducible queries that use exactly the same table snapshot, or lets users easily examine changes
+* Version rollback allows users to quickly correct problems by resetting tables to a good state
+
+### Reliability and performance
+
+Iceberg was built for huge tables. Iceberg is used in production where a single table can contain tens of petabytes of data and even these huge tables can be read without a distributed SQL engine.
+
+* [Scan planning is fast](performance#scan-planning) -- a distributed SQL engine isn't needed to read a table or find files
+* [Advanced filtering](performance#data-filtering) -- data files are pruned with partition and column-level stats, using table metadata
+
+Iceberg was designed to solve correctness problems in eventually-consistent cloud object stores.
+
+* [Works with any cloud store](reliability) and reduces NN congestion when in HDFS, by avoiding listing and renames
+* [Serializable isolation](reliability) -- table changes are atomic and readers never see partial or uncommitted changes
+* [Multiple concurrent writers](reliability#concurrent-write-operations) use optimistic concurrency and will retry to ensure that compatible updates succeed, even when writes conflict
+
+### Open standard
+
+Iceberg has been designed and developed to be an open community standard with a [specification](../../spec) to ensure compatibility across languages and implementations.
+
+[Apache Iceberg is open source](../../community), and is developed at the [Apache Software Foundation](https://www.apache.org/).
+
diff --git a/docs/api/_index.md b/docs/api/_index.md
diff --git a/docs/api/javadoc/_index.md b/docs/api/javadoc/_index.md
diff --git a/docs/asf/_index.md b/docs/asf/_index.md
diff --git a/docs/asf/donate/_index.md b/docs/asf/donate/_index.md
diff --git a/docs/asf/events/_index.md b/docs/asf/events/_index.md
diff --git a/docs/asf/license/_index.md b/docs/asf/license/_index.md
diff --git a/docs/asf/security/_index.md b/docs/asf/security/_index.md
diff --git a/docs/asf/sponsors/_index.md b/docs/asf/sponsors/_index.md
diff --git a/docs/athena/_index.md b/docs/athena/_index.md
diff --git a/docs/integrations/aws.md → docs/aws.md b/docs/integrations/aws.md → docs/aws.md
@@ -1,6 +1,10 @@
 ---
 title: "AWS"
 url: aws
+menu:
+    main:
+        parent: Integrations
+        weight: 0
 ---
 <!--
  - Licensed to the Apache Software Foundation (ASF) under one or more

diff --git a/docs/community/blogs.md → docs/blogs.md b/docs/community/blogs.md → docs/blogs.md
@@ -1,7 +1,10 @@
 ---
 title: "Blogs"
-weight: 200
-bookUrlFromBaseURL: /../../blogs
+relurl: "../../blogs"
+menu:
+    main:
+        parent: Community
+        weight: 0
 ---
 <!--
  - Licensed to the Apache Software Foundation (ASF) under one or more

diff --git a/docs/community/_index.md b/docs/community/_index.md
diff --git a/docs/tables/configuration.md → docs/configuration.md b/docs/tables/configuration.md → docs/configuration.md
@@ -2,6 +2,10 @@
 url: configuration
 aliases:
     - "tables/configuration"
+menu:
+    main:
+        parent: Tables
+        weight: 0
 ---
 <!--
  - Licensed to the Apache Software Foundation (ASF) under one or more

diff --git a/docs/community/contributing.md → docs/contributing.md b/docs/community/contributing.md → docs/contributing.md
@@ -1,7 +1,10 @@
 ---
 title: "Contribute"
-weight: 400
-bookUrlFromBaseURL: /../../contribute
+relurl: "../../contributing"
+menu:
+    main:
+        parent: Community
+        weight: 0
 ---
 <!--
  - Licensed to the Apache Software Foundation (ASF) under one or more

diff --git a/docs/dremio/_index.md b/docs/dremio/_index.md
diff --git a/docs/emr/_index.md b/docs/emr/_index.md
diff --git a/docs/tables/evolution.md → docs/evolution.md b/docs/tables/evolution.md → docs/evolution.md
@@ -1,7 +1,12 @@
 ---
+title: Evolution
 url: evolution
 aliases:
     - "tables/evolution"
+menu:
+    main:
+        parent: Tables
+        weight: 0
 ---
 <!--
  - Licensed to the Apache Software Foundation (ASF) under one or more

diff --git a/docs/flink/flink-connector.md → docs/flink-connector.md b/docs/flink/flink-connector.md → docs/flink-connector.md
@@ -1,7 +1,12 @@
 ---
+title: "Flink Connector"
 url: flink-connector
 aliases:
     - "flink/flink-connector"
+menu:
+    main:
+        parent: Flink
+        weight: 200
 ---
 <!--
  - Licensed to the Apache Software Foundation (ASF) under one or more

diff --git a/docs/flink/flink-getting-started.md → docs/flink-getting-started.md b/docs/flink/flink-getting-started.md → docs/flink-getting-started.md
@@ -1,7 +1,10 @@
 ---
-title: "Getting Started"
-weight: 300
+title: "Enabling Iceberg in Flink"
 url: flink
+menu:
+    main:
+        parent: Flink
+        weight: 100
 ---
 <!--
  - Licensed to the Apache Software Foundation (ASF) under one or more

diff --git a/docs/flink/_index.md b/docs/flink/_index.md
diff --git a/docs/format/_index.md b/docs/format/_index.md