kubernetes/website

Add actual priority values for built-in PriorityClasses to documentation

Open

#54107 opened on Jan 23, 2026

View on GitHub
 (6 comments) (0 reactions) (1 assignee)HTML (4,127 stars) (13,918 forks)batch import
help wantedkind/featurelanguage/enpriority/backlogtriage/accepted

Description

This is a Feature Request

What would you like to be added

Add the actual priority values for the built-in PriorityClasses (system-cluster-critical and system-node-critical) to the Pod Priority and Preemption page.

Why is this needed?

The current documentation mentions these built-in PriorityClasses but doesn't specify their actual priority values:

  • system-node-critical: 2000001000
  • system-cluster-critical: 2000000000

Users can see these values by running kubectl get priorityclasses, but having them in the documentation would provide better context when choosing right priority values for custom PriorityClasses.

If this is valuable, /assign

Contributor guide

Tech stack
html
Domain
documentation
Issue type
feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
under 1 hour
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
None
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
90
Research direction
The issue asks to add priority values for system cluster critical and system node critical to the Pod Priority and Preemption documentation page. The exact values are 2000000000 and 2000001000 respectively. This requires editing the appropriate markdown file in the kubernetes/website repository, likely under content/en/docs/concepts/scheduling eviction/pod priority preemption.md. The contributor can verify the current file and add the values in the section discussing built in PriorityClasses.