chore(docs): reformat docs/getting-started catalog

Author: binarycat0

site/content/in-dev/unreleased/getting-started/alternate-conf/keycloak-idp.md

@@ -0,0 +1,31 @@
+---
+#
+# 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.
+#
+title: Creating a Catalog
+linkTitle: Creating a Catalog
+type: docs
+weight: 300
+---
+
+The following Object Storage providers can be configured as storage backends for your Polaris catalog:
+
+- [S3 compatible object stores]({{< ref "s3.md" >}})
+- [Google Cloud Storage]({{< ref "catalog-gcs.md" >}})
+- [Azure Blob Storage]({{< ref "catalog-azure.md" >}})
+- Local file system (By default for testing only)

site/content/in-dev/unreleased/getting-started/creating-a-catalog/_index.md

@@ -17,10 +17,10 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-title: Alternate Configurations
-linkTitle: Alternate configurations ⛕
+title: Creating a catalog on Azure
+linkTitle: Azure
 type: docs
-weight: 400
+weight: 300
 ---
 
-This section presents ready-to-use examples of alternative Apache Polaris configurations for various deployment scenarios and integrations.
+TBD

site/content/in-dev/unreleased/getting-started/alternate-conf/_index.md renamed to site/content/in-dev/unreleased/getting-started/creating-a-catalog/catalog-azure.md

@@ -0,0 +1,26 @@
+---
+#
+# 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.
+#
+title: Creating a catalog on Google Cloud Storage (GCS)
+linkTitle: GCS
+type: docs
+weight: 200
+---
+
+TBD

site/content/in-dev/unreleased/getting-started/creating-a-catalog/catalog-gcs.md

@@ -0,0 +1,29 @@
+---
+#
+# 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.
+#
+title: Creating a catalog on S3 compatible cloud providers
+linkTitle: S3
+type: docs
+weight: 100
+---
+
+The following S3 compatible cloud providers can be configured as storage backends for your Polaris catalog:
+
+- [AWS S3]({{< ref "catalog-aws.md" >}})
+- [MinIO]({{< ref "catalog-minio.md" >}})

site/content/in-dev/unreleased/getting-started/creating-a-catalog/s3/_index.md

@@ -0,0 +1,26 @@
+---
+#
+# 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.
+#
+title: Creating a catalog on AWS S3
+linkTitle: AWS
+type: docs
+weight: 100
+---
+
+TBD

site/content/in-dev/unreleased/getting-started/creating-a-catalog/s3/catalog-aws.md

@@ -17,9 +17,10 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-Title: Deploying Polaris on MinIO
+title: Creating a catalog on MinIO
+linkTitle: MinIO
 type: docs
-weight: 100
+weight: 200
 ---
 
 In this guide we walk through setting up a simple Polaris Server with local [MinIO](https://www.min.io/) storage.
@@ -42,7 +43,7 @@ docker compose -f getting-started/minio/docker-compose.yml up
 ```
 
 The compose script will start MinIO on default ports (API on 9000, UI on 9001)
-plus a Polaris Server pre-configured to that MinIO instance. 
+plus a Polaris Server pre-configured to that MinIO instance.
 
 In this example the `root` principal has its password set to `s3cr3t`.
 
@@ -86,7 +87,7 @@ mc ls pol/bucket123/ns/t1
 [2025-08-13 18:52:38 EDT]     0B metadata/
 ```
 
-Note: the values of `minio_root`, `m1n1opwd` and `bucket123` are defined in the docker compose file. 
+Note: the values of `minio_root`, `m1n1opwd` and `bucket123` are defined in the docker compose file.
 
 # Notes on Storage Configuation
 

site/content/in-dev/unreleased/getting-started/alternate-conf/minio.md renamed to site/content/in-dev/unreleased/getting-started/creating-a-catalog/s3/catalog-minio.md

@@ -23,6 +23,7 @@ type: docs
 weight: 200
 ---
 
-We will now demonstrate how to deploy Polaris locally, as well as with all supported Cloud Providers: Amazon Web Services (AWS), Azure, and Google Cloud Platform (GCP).
+Here you can find the guides of how to deploy Polaris locally, as well as with all supported Cloud Providers: Amazon Web Services (AWS), Azure, and Google Cloud Platform (GCP).
 
-Locally, Polaris can be deployed using both Docker and local build. On the cloud, this tutorial will deploy Polaris using Docker only - but local builds can also be executed.
+Locally, Polaris can be deployed using both docker and local build. 
+On the cloud, the following tutorials will deploy Polaris using docker environment.