📖docs: add galaxy marketplace documentation

[arnavgogia20]

Summary

This pull request improves and refines the Marketplace documentation by enhancing clarity, structure, and completeness.
The changes are focused purely on documentation and are intended to better explain the Marketplace UI, its features, and user workflows.

Although the original issue was raised in the UI repository, the mentor requested that the fix be implemented in the Docs repository, which is why this PR lives here.

---

What’s Changed

• Cleaned up and restructured the existing marketplace.md documentation
• Improved section hierarchy for better readability and navigation
• Added clearer explanations of Marketplace features and UI behavior
• Standardized formatting using MDX best practices (headings, lists, code blocks)
• Removed ambiguity and improved overall documentation quality

---

Scope of Changes

• Documentation-only update
• No UI, backend, or logic changes
• No breaking changes introduced

---

Testing & Verification

• All existing checks and validations pass successfully
• No automated tests were affected, as this PR only updates documentation
• Content has been manually reviewed for accuracy and consistency

---

Notes for Reviewers

• This PR intentionally does not reference or tag a GitHub issue, as the issue exists in the UI repository
• The documentation can be reviewed independently without needing UI context
• Feedback on clarity, structure, or missing details is very welcome

---

Thank you for reviewing!!

[kubestellar-prow]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign sagar2366 for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details

Needs approval from an approver in each of these files:

• OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[netlify]

✅ Deploy Preview for kubestellar-docs ready!

Built without sensitive environment variables

Name	Link
🔨 Latest commit	687e496
🔍 Latest deploy log	https://app.netlify.com/projects/kubestellar-docs/deploys/69678952decf80000832ce54
😎 Deploy Preview	https://deploy-preview-656--kubestellar-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[github-actions]

Welcome to KubeStellar! 🚀 Thank you for submitting this Pull Request.

Before your PR can be merged, please ensure:

✅ DCO Sign-off - All commits must be signed off with git commit -s to certify the Developer Certificate of Origin

✅ PR Title - Must start with an emoji: ✨ (feature), 🐛 (bug fix), 📖 (docs), 🌱 (infra/tests), ⚠️ (breaking change)

Getting Started with KubeStellar:

• 📦 Quick Start
• 📖 Documentation
• 🎬 YouTube - Getting Started & Contributing

Contributor Resources:

• 📚 Contributor Handbook
• 🪜 Contributor Ladder
• 🎓 Mentorship Programs (LFX, GSoC)
• 💬 Slack - #kubestellar-dev

---

🌟 Help KubeStellar Grow - We Need Adopters!

Our roadmap is driven entirely by adopter feedback. Whether you're using KubeStellar yourself or know someone who could benefit from multi-cluster Kubernetes:

📋 Take our Multi-Cluster Survey - Share your use cases and help shape our direction!

---

A maintainer will review your PR soon. Feel free to ask questions in the comments or on Slack!

[kubestellar-prow]

Hi @arnavgogia20. Thanks for your PR.

I'm waiting for a kubestellar member to verify that this patch is reasonable to test. If it is, they should reply with /ok-to-test on its own line. Until that is done, I will not automatically test new commits in this PR, but the usual testing commands by org members will still work. Regular contributors should join the org to skip this step.

Once the patch is verified, the new status will be reflected by the ok-to-test label.

I understand the commands that are listed here.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

[clubanderson]

/ok-to-test

fix your pr title to satisfy the ci @arnavgogia20

[clubanderson]

❌ PR Title Verification Failed

Your PR title does not follow the required format.

Current title: docs: add galaxy marketplace documentation

Required Format

PR titles must start with one of these emoji prefixes:

Emoji	Meaning
⚠️	Breaking change
✨	Non-breaking feature
🐛	Patch fix / Bug fix
📖	Documentation
🚀	Release
🌱	Infra/Tests/Other

How to Fix

Edit your PR title to start with the appropriate emoji. For example:

• ✨ Add new feature for user authentication
• 🐛 Fix crash when loading empty config
• 📖 Update installation guide

You can edit the title by clicking the Edit button next to your PR title.

---

This comment was posted to help you fix the PR title format.

[arnavgogia20]

@oksaumya @btwshivam pls review the PR