Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Enhance a template/checklist for KEP contributors to determine "Needs Docs" #2595

Open
drewhagen opened this issue Aug 10, 2024 · 1 comment
Labels
kind/documentation Categorizes issue or PR as related to documentation. lifecycle/stale Denotes an issue or PR has remained open with no activity and has become stale. priority/backlog Higher priority than priority/awaiting-more-evidence.

Comments

@drewhagen
Copy link
Member

Feature Request

Create or enhance a template/checklist with clear requirements for "needs docs" for a KEP.

Background

Each cycle, shadows and lead of Release Docs reaches out to the author and ask if they need documentation for their KEP. There is a simple template in our docs handbook that is copy/pasted into the KEP asking if they need docs and if so, open up a placeholder PR by a deadline.

However, this template doesn't provide KEP contributors much guidance about when docs are required.

Why this is Needed

While most SIGs know that contributing a feature gate requires documentation, we've still had some that have gone undocumented in recent cycles. The requirement to document feature gates is one example of something we can communicate guidance on. (maybe we can think of others? idk - might need to ask SIG Docs)

Alternative

An alternative is to ask SIG Docs to provide more clarity on when docs are required on this page on the website:
https://kubernetes.io/docs/contribute/new-content/new-features/#for-developers-or-other-sig-members

Release Docs's outreach includes a link to this page about opening a placeholder PR/

If we got that route, we should open an issue on the website repo and communicate with SIG Docs.

@k8s-ci-robot k8s-ci-robot added needs-kind Indicates a PR lacks a `kind/foo` label and requires one. needs-priority labels Aug 10, 2024
@drewhagen drewhagen added priority/backlog Higher priority than priority/awaiting-more-evidence. kind/documentation Categorizes issue or PR as related to documentation. and removed needs-kind Indicates a PR lacks a `kind/foo` label and requires one. needs-priority labels Aug 10, 2024
@k8s-triage-robot
Copy link

The Kubernetes project currently lacks enough contributors to adequately respond to all issues.

This bot triages un-triaged issues according to the following rules:

  • After 90d of inactivity, lifecycle/stale is applied
  • After 30d of inactivity since lifecycle/stale was applied, lifecycle/rotten is applied
  • After 30d of inactivity since lifecycle/rotten was applied, the issue is closed

You can:

  • Mark this issue as fresh with /remove-lifecycle stale
  • Close this issue with /close
  • Offer to help out with Issue Triage

Please send feedback to sig-contributor-experience at kubernetes/community.

/lifecycle stale

@k8s-ci-robot k8s-ci-robot added the lifecycle/stale Denotes an issue or PR has remained open with no activity and has become stale. label Nov 8, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
kind/documentation Categorizes issue or PR as related to documentation. lifecycle/stale Denotes an issue or PR has remained open with no activity and has become stale. priority/backlog Higher priority than priority/awaiting-more-evidence.
Projects
None yet
Development

No branches or pull requests

3 participants