Skip to content

Site: clean up "Getting Started" guide with actual quickstart content#4392

Open
venkateshwaracholan wants to merge 2 commits into
apache:mainfrom
venkateshwaracholan:site-quickstart-getting-started-cleanup
Open

Site: clean up "Getting Started" guide with actual quickstart content#4392
venkateshwaracholan wants to merge 2 commits into
apache:mainfrom
venkateshwaracholan:site-quickstart-getting-started-cleanup

Conversation

@venkateshwaracholan
Copy link
Copy Markdown
Contributor

@venkateshwaracholan venkateshwaracholan commented May 10, 2026

Addresses #3884.

The "Getting Started" guide page became sparse after #3550 moved files
around. As suggested by @adutra in the review, this PR brings the actual
quickstart content into the guide page directly, rather than redirecting
users elsewhere.

Changes:

  • Replace the redirect-only content with actual quickstart instructions
  • Add prerequisites, running instructions, and next steps

Checklist

  • 🛡️ Don't disclose security issues! (contact security@apache.org)
  • 🔗 Clearly explained why the changes are needed, or linked related issues: Addresses Site: Clean up "Getting Started" #3884
  • 🧪 Added/updated tests with good coverage, or manually tested (and explained how)
  • 💡 Added comments for complex logic
  • 🧾 Updated CHANGELOG.md (if needed)
  • 📚 Updated documentation in site/content/in-dev/unreleased (if needed)

@venkateshwaracholan venkateshwaracholan force-pushed the site-quickstart-getting-started-cleanup branch from a344e01 to d4078cd Compare May 10, 2026 03:13
@jbonofre jbonofre self-requested a review May 10, 2026 03:39
Comment thread site/content/guides/quickstart/index.md Outdated
#
# Licensed to the Apache Software Foundation (ASF) under one
# or more contributor license agreements. See the NOTICE file
# or more contributor license agreements. See the NOTICE file
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: please avoid unecessary changes.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reverted the unintentional whitespace changes in the license header

Comment thread site/content/guides/quickstart/index.md Outdated

To stop the services:
```bash
docker compose down
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This command won't work I believe if not execute in the right directory.

We should inform the user that it has to run docker compose down in the directory where docker compose up has been executed.
Another approach would be to use -p polaris-quitckstart on both docker compose up and docker compose down commands.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Used -p polaris-quickstart on all commands so down works from any directory, and added a logs command so users can still see output

Comment thread site/content/guides/quickstart/index.md Outdated
Run the following command:

```bash
curl -s https://raw.githubusercontent.com/apache/polaris/refs/heads/main/site/content/guides/quickstart/docker-compose.yml | docker compose -f - up
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This will run on foreground. Do we want this or use docker compose -d to start in background (daemon)?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added -d to run in background

@venkateshwaracholan venkateshwaracholan force-pushed the site-quickstart-getting-started-cleanup branch from 7dbfa47 to cf966b5 Compare May 10, 2026 04:14
@venkateshwaracholan
Copy link
Copy Markdown
Contributor Author

@jbonofre Thank you for the review! I've addressed all the comments. Could you please take another look when you get a chance? Thanks!

Copy link
Copy Markdown
Member

@jbonofre jbonofre left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks a lot! LGTM

@github-project-automation github-project-automation Bot moved this from PRs In Progress to Ready to merge in Basic Kanban Board May 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants