Skip to content

Add why guidance to task pages and reference Diátaxis#55652

Open
kfess wants to merge 1 commit intokubernetes:mainfrom
kfess:issue-55445
Open

Add why guidance to task pages and reference Diátaxis#55652
kfess wants to merge 1 commit intokubernetes:mainfrom
kfess:issue-55445

Conversation

@kfess
Copy link
Copy Markdown
Member

@kfess kfess commented May 3, 2026

Description

Update the task page contributor guidance in page-content-types.md and add a reference to the Diátaxis framework.

Issue

Closes: #55445

@k8s-ci-robot k8s-ci-robot added the cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. label May 3, 2026
@k8s-ci-robot k8s-ci-robot added the language/en Issues or PRs related to English language label May 3, 2026
@k8s-ci-robot
Copy link
Copy Markdown
Contributor

[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 natalisucks 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:

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 size/S Denotes a PR that changes 10-29 lines, ignoring generated files. label May 3, 2026
@netlify
Copy link
Copy Markdown

netlify Bot commented May 3, 2026

Pull request preview available for checking

Built without sensitive environment variables

Name Link
🔨 Latest commit 9247f59
🔍 Latest deploy log https://app.netlify.com/projects/kubernetes-io-main-staging/deploys/69f73d1cba0fd500088cb9dc
😎 Deploy Preview https://deploy-preview-55652--kubernetes-io-main-staging.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

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

Copy link
Copy Markdown
Member

@lmktfy lmktfy left a comment

Choose a reason for hiding this comment

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

Thanks for the improvement.

/lgtm

@k8s-ci-robot k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label May 3, 2026
@k8s-ci-robot
Copy link
Copy Markdown
Contributor

LGTM label has been added.

DetailsGit tree hash: a55a5dedcaafd28e6abb805ed7f51ddcc8113bfb

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. language/en Issues or PRs related to English language lgtm "Looks good to me", indicates that a PR is ready to be merged. size/S Denotes a PR that changes 10-29 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Improve task page contribution guidance to explain "why" and stay focused on the task

3 participants