docs: Update learn docs for projects

[vyncent-t]

Summary

This PR updates the Learn section docs for Projects as edited from Will (please message me if you need the original changes doc from Will)

Note: After this PR is merged it will need to a PR for a netlify rebuild for the docs changes to update on live
PR for rebuild - x

Changes

• Updates docs with new content

Screenshots (if applicable)

Assets

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is NOT APPROVED

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

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

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

[skoeva]

left some suggestions, I would advise running this through hemingway or some other program to keep the docs accessible if you haven't already

[Copilot]

Pull Request Overview

This PR reimagines the Projects documentation with a developer-first, use-case-driven approach. Instead of presenting Projects as a technical feature, the update positions them as a solution to real workflow challenges like fragmentation, onboarding friction, and troubleshooting complexity.

• Rewrote the introduction and overview to emphasize developer experience and application-centric workflow benefits
• Added "Why Use Projects" and "Use Cases" sections with concrete scenarios for multi-environment management, onboarding, and troubleshooting
• Streamlined the "Creating a Project" and "Working with Projects" sections for clarity and brevity, and added UI screenshots

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.