chore(docs): reorganize getting-started section

site/content/in-dev/unreleased/_index.md

@@ -172,7 +172,7 @@ Polaris RBAC uses two different role types to delegate privileges:
 - **Catalog roles:** Configured with certain privileges on Polaris
   catalog resources and granted to principal roles.
 
-For more information, see [Access control]({{% ref "access-control" %}}).
+For more information, see [Access control]({{% ref "managing-security/access-control" %}}).
 
 ## Legal Notices
 

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

@@ -17,9 +17,23 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-title: 'Getting Started'
+title: Getting Started with Apache Polaris
+linkTitle: Getting Started
 type: docs
 weight: 101
-build:
-  render: never
 ---
+
+The fastest way to get started is with our Docker Compose examples. Each example provides a complete working environment with detailed instructions.
+
+## Next Steps
+
+1. Check/Install dependencies
+2. Choose the way you want to deploy Polaris
+3. Create a catalog
+4. Check Using polaris page
+
+## Getting Help
+
+- Documentation: https://polaris.apache.org
+- GitHub Issues: https://github.com/apache/polaris/issues
+- Slack: [Join Apache Polaris Community](https://join.slack.com/t/apache-polaris/shared_invite/zt-2y3l3r0fr-VtoW42ltir~nSzCYOrQgfw)

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

@@ -0,0 +1,54 @@
+---
+#
+# 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)
+
+
+## Create a catalog using polaris CLI
+
+Check full list of options for the `polaris catalogs create` command [here]({{% ref "../../command-line-interface#create" %}})
+
+### Example
+
+```shell
+CLIENT_ID=root \
+CLIENT_SECRET=s3cr3t \
+DEFAULT_BASE_LOCATION=s3://example-bucket/my_data \
+ROLE_ARN=arn:aws:iam::111122223333:role/ExampleCorpRole \
+./polaris \
+  --client-id ${CLIENT_ID} \
+  --client-secret ${CLIENT_SECRET} \
+  catalogs \
+  create \
+  --storage-type s3 \
+  --default-base-location ${DEFAULT_BASE_LOCATION} \
+  --role-arn ${ROLE_ARN} \
+  my_catalog
+```

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

@@ -0,0 +1,55 @@
+---
+#
+# 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 Azure
+linkTitle: Azure
+type: docs
+weight: 300
+---
+
+For the `polaris catalogs create` [command]({{% ref "../../command-line-interface#create" %}}) there are few `azure` only options
+
+```text
+--storage-type azure
+--tenant-id  (Required for Azure) A tenant ID to use when connecting to Azure Storage
+--multi-tenant-app-name  (Only for Azure) The app name to use when connecting to Azure Storage
+--consent-url  (Only for Azure) A consent URL granting permissions for the Azure Storage location
+```
+
+### example
+
+```shell
+CLIENT_ID=root \
+CLIENT_SECRET=s3cr3t \
+DEFAULT_BASE_LOCATION=abfss://[email protected] \
+TENANT_ID=tenant123.onmicrosoft.com \
+MULTI_TENANT_APP_NAME=myapp \
+CONSENT_URL=https://myapp.com/consent
+./polaris \
+  --client-id ${CLIENT_ID} \
+  --client-secret ${CLIENT_SECRET} \
+  catalogs \
+  create \
+  --storage-type azure \
+  --tenant-id ${TENANT_ID} \
+  --multi-tenant-app-name ${MULTI_TENANT_APP_NAME} \
+  --consent-url ${CONSENT_URL} \
+  --default-base-location ${DEFAULT_BASE_LOCATION} \
+  my_azure_catalog
+```

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

@@ -0,0 +1,49 @@
+---
+#
+# 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
+---
+
+For the `polaris catalogs create` [command]({{% ref "../../command-line-interface#create" %}}) there are few `gcs` only options
+
+```text
+--storage-type gcs
+--service-account  (Only for GCS) The service account to use when connecting to GCS
+```
+
+### example
+
+```shell
+CLIENT_ID=root \
+CLIENT_SECRET=s3cr3t \
+DEFAULT_BASE_LOCATION=gs://my-ml-bucket/predictions/  \
+SERVICE_ACCOUNT=serviceAccount:[email protected] \
+./polaris \
+  --client-id ${CLIENT_ID} \
+  --client-secret ${CLIENT_SECRET} \
+  catalogs \
+  create \
+  --storage-type gcs \
+  --service-account ${SERVICE_ACCOUNT} \
+  --default-base-location ${DEFAULT_BASE_LOCATION} \
+  my_gcs_catalog
+```

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

@@ -0,0 +1,38 @@
+---
+#
+# 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" >}})
+
+For the `polaris catalogs create` [command]({{% ref "../../../command-line-interface#create" %}}) there are few `s3` only options
+
+```text
+--storage-type s3
+--role-arn  (Required for S3) A role ARN to use when connecting to S3
+--region  (Only for S3) The region to use when connecting to S3
+--external-id  (Only for S3) The external ID to use when connecting to S3
+```

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

@@ -0,0 +1,47 @@
+---
+#
+# 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
+---
+
+
+### example
+
+```shell
+CLIENT_ID=root \
+CLIENT_SECRET=s3cr3t \
+DEFAULT_BASE_LOCATION=s3://example-bucket/my_data \
+ROLE_ARN=arn:aws:iam::111122223333:role/ExampleCorpRole \
+REGION=us-west-2 \
+EXTERNAL_ID=12345678901234567890 \
+./polaris \
+  --client-id ${CLIENT_ID} \
+  --client-secret ${CLIENT_SECRET} \
+  catalogs \
+  create \
+  --storage-type s3 \
+  --default-base-location ${DEFAULT_BASE_LOCATION} \
+  --role-arn ${ROLE_ARN} \
+  --region ${REGION} \
+  --external-id ${EXTERNAL_ID} \
+  my_aws_catalog
+```

site/content/in-dev/unreleased/getting-started/minio.md → site/content/in-dev/unreleased/getting-started/creating-a-catalog/s3/catalog-minio.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: 350
+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/deploying-polaris/_index.md

@@ -17,11 +17,13 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-Title: Deploying Polaris on Cloud Providers
+title: Deploying Polaris
+linkTitle: Deploying Polaris
 type: docs
-weight: 300
+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.

site/content/in-dev/unreleased/getting-started/deploying-polaris/cloud-deploy/_index.md

@@ -0,0 +1,27 @@
+---
+#
+# 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: Deploying Polaris on Cloud Providers
+linkTitle: Cloud Providers
+type: docs
+weight: 300
+---
+
+Polaris can be deployed on various cloud providers, including Amazon Web Services (AWS), Azure, and Google Cloud Platform (GCP). 
+In the following guides, we will walk you through the process of deploying Polaris on each of these cloud providers.

site/content/in-dev/unreleased/getting-started/deploying-polaris/quickstart-deploy-aws.md → site/content/in-dev/unreleased/getting-started/deploying-polaris/cloud-deploy/deploy-aws.md

@@ -17,7 +17,8 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-Title: Deploying Polaris on Amazon Web Services (AWS)
+title: Deploying Polaris on Amazon Web Services (AWS)
+linkTitle: AWS
 type: docs
 weight: 310
 ---
@@ -44,7 +45,7 @@ export CLIENT_SECRET=s3cr3t
 ```
 
 ## Next Steps
-Congrats, you now have a running instance of1 Polaris! For details on how to use Polaris, check out the [Using Polaris]({{% relref "../using-polaris" %}}) page.
+Congrats, you now have a running instance of1 Polaris! For details on how to use Polaris, check out the [Using Polaris]({{% relref "../../using-polaris" %}}) page.
 
 ## Cleanup Instructions
 To shut down the Polaris server, run the following commands:
@@ -54,4 +55,4 @@ export ASSETS_PATH=$(pwd)/getting-started/assets/
 docker compose -p polaris -f getting-started/eclipselink/docker-compose.yml down
 ```
 
-To deploy Polaris in a production setting, please review further recommendations at the [Configuring Polaris for Production]({{% relref "../../configuring-polaris-for-production" %}}) page.
+To deploy Polaris in a production setting, please review further recommendations at the [Configuring Polaris for Production]({{% relref "../../../configuring-polaris-for-production" %}}) page.