bitsondatadev opened a new issue, #7785: URL: https://github.com/apache/iceberg/issues/7785
### Feature Request / Improvement One common point of confusion that I've seen in the Trino and Iceberg communities, is the lack of a general definition of what a catalog is in the context of Iceberg. The term `catalog` is an incredibly overloaded word in the data space in general, and we need a clear section that defines and establishes what a catalog is. The documentation on catalogs is fragmented. The [Nessie](https://iceberg.apache.org/docs/latest/nessie/) and [JDBC](https://iceberg.apache.org/docs/latest/jdbc/) catalogs are under the Integrations section. The main way you hear about catalogs is through the [Java API quickstart](https://iceberg.apache.org/docs/latest/java-api-quickstart/) and custom catalog docs under the API section. The [Spark catalog docs](https://iceberg.apache.org/spark-quickstart/#adding-a-catalog) are under the Spark page rather than the integrations page where Nessie and JDBC are located. The REST catalog documentation is nowhere to be found. It's a mess. I think we should have a central location that defines and showcases the documentation for all catalogs, their settings, and other properties or setup needed. Any other locations that currently have them will reference to this central page. ### Query engine None -- 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: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
