Skip to content

Conversation

@vyncent-t
Copy link
Contributor

@vyncent-t vyncent-t commented Nov 6, 2025

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
image

image

@vyncent-t vyncent-t self-assigned this Nov 6, 2025
@k8s-ci-robot k8s-ci-robot requested review from skoeva and sniok November 6, 2025 19:00
@k8s-ci-robot k8s-ci-robot added cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels Nov 6, 2025
Copy link
Contributor

@skoeva skoeva left a comment

Choose a reason for hiding this comment

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

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

@illume illume requested a review from Copilot November 7, 2025 15:29
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

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.

@illume illume added this to the v0.38.0 milestone Nov 10, 2025
@illume
Copy link
Contributor

illume commented Nov 10, 2025

@vyncent-t

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

Are you able to do this in this PR or in another one soon? There's a lot of complex sentences in there.

Copy link
Contributor

@illume illume left a comment

Choose a reason for hiding this comment

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

🎉 thanks

@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: illume, vyncent-t

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

The pull request process is described here

Needs approval from an approver in each of these files:

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

@k8s-ci-robot k8s-ci-robot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Nov 10, 2025
@illume
Copy link
Contributor

illume commented Nov 10, 2025

I'll merge this in now, and any further work can come in future PRs.

@illume illume merged commit f5ccc65 into kubernetes-sigs:main Nov 10, 2025
1 of 2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

approved Indicates a PR has been approved by an approver from all required OWNERS files. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. size/M Denotes a PR that changes 30-99 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants