liurenjie1024 commented on code in PR #1616: URL: https://github.com/apache/iceberg-rust/pull/1616#discussion_r2284758526
########## website/src/api.md: ########## @@ -24,8 +24,22 @@ * Create and list namespaces. * Create, load, and drop tables -Currently only rest catalog has been implemented, and other catalogs are under active development. Here is an -example of how to create a `RestCatalog`: +There is support for the following catalogs: + +| Catalog | Description | +|---------|------------| +| `RestCatalog` | the Iceberg REST catalog | Review Comment: ```suggestion | `Rest` | the Iceberg REST catalog | ``` ########## website/src/introduction.md: ########## @@ -19,4 +19,19 @@ # Iceberg Rust -Iceberg Rust is a rust implementation for accessing iceberg tables. +`iceberg-rust` is a Rust implementation for managing Apache Iceberg tables. + +## What is Apache Iceberg? + +[Apache Iceberg](https://iceberg.apache.org/docs/nightly/) is a modern, high-performance open table format Review Comment: ```suggestion [Apache Iceberg](https://iceberg.apache.org) is a modern, high-performance open table format ``` ########## website/src/introduction.md: ########## @@ -19,4 +19,19 @@ # Iceberg Rust -Iceberg Rust is a rust implementation for accessing iceberg tables. +`iceberg-rust` is a Rust implementation for managing Apache Iceberg tables. + +## What is Apache Iceberg? + +[Apache Iceberg](https://iceberg.apache.org/docs/nightly/) is a modern, high-performance open table format +for huge analytic datasets that brings SQL-like tables to processing engines including Spark, Trino, PrestoDB, Flink, Hive and Impala. + +Rather than being a new file type, Iceberg provides a metadata layer that sits on top of formats like Parquet +and ORC, ensuring data is organized, accessible, and safe to work with at scale. It introduces features long +expected in databases such as transactional consistency, schema evolution, and time travel into environments +where files are stored directly on systems like Amazon S3 or HDFS. + +Originally developed at Netflix, it was designed as a response to the limitations of early Hive tables, which were +essentially directories of files with only loose conventions for schema and partitioning. While this approach +enabled cheap storage of large datasets, it struggled with schema changes, concurrent writes, and efficient query +planning. Review Comment: How about removing this part ? These are copied from official website. ########## website/src/api.md: ########## @@ -24,8 +24,22 @@ * Create and list namespaces. * Create, load, and drop tables -Currently only rest catalog has been implemented, and other catalogs are under active development. Here is an -example of how to create a `RestCatalog`: +There is support for the following catalogs: + +| Catalog | Description | +|---------|------------| +| `RestCatalog` | the Iceberg REST catalog | +| `Glue` | the AWS Glue Data Catalog | +| `MemoryCatalog` | a memory-based Catalog | Review Comment: ```suggestion | `Memory` | a memory-based Catalog | ``` -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: issues-unsubscr...@iceberg.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org --------------------------------------------------------------------- To unsubscribe, e-mail: issues-unsubscr...@iceberg.apache.org For additional commands, e-mail: issues-h...@iceberg.apache.org
