Skip to content

Commit f40fb17

Browse files
Merge branch 'kubernetes:main' into patch-1
2 parents 36485b9 + 40b1a80 commit f40fb17

File tree

1,975 files changed

+216552
-26791
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

1,975 files changed

+216552
-26791
lines changed

.editorconfig

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,3 +21,6 @@ insert_final_newline = true
2121

2222
[Makefile]
2323
indent_style = tab
24+
25+
[OWNERS]
26+
indent_size = 2

Makefile

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,9 @@ HUGO_VERSION = $(shell grep ^HUGO_VERSION netlify.toml | tail -n 1 | cut -d
22
NODE_BIN = node_modules/.bin
33
NETLIFY_FUNC = $(NODE_BIN)/netlify-lambda
44

5+
# The segments variable is used to specify which segments to render.
6+
segments ?= all
7+
58
# The CONTAINER_ENGINE variable is used for specifying the container engine. By default 'docker' is used
69
# but this can be overridden when calling make, e.g.
710
# CONTAINER_ENGINE=podman make container-image
@@ -69,7 +72,7 @@ non-production-build: module-check ## Build the non-production site, which adds
6972
GOMAXPROCS=1 hugo --cleanDestinationDir --enableGitInfo --environment nonprod
7073

7174
serve: module-check ## Boot the development server.
72-
hugo server --buildDrafts --buildFuture --environment development
75+
hugo server --buildDrafts --buildFuture --environment development --renderSegments $(segments)
7376

7477
docker-image:
7578
@echo -e "$(CCRED)**** The use of docker-image is deprecated. Use container-image instead. ****$(CCEND)"
@@ -118,7 +121,7 @@ container-build: module-check
118121
container-serve: module-check ## Boot the development server using container.
119122
$(CONTAINER_RUN_TTY) --cap-drop=ALL --cap-add=AUDIT_WRITE $(CONTAINER_HUGO_MOUNTS) \
120123
-p 1313:1313 $(CONTAINER_IMAGE) \
121-
hugo server --buildDrafts --buildFuture --environment development --bind 0.0.0.0 --destination /tmp/public --cleanDestinationDir --noBuildLock
124+
hugo server --buildDrafts --buildFuture --environment development --bind 0.0.0.0 --destination /tmp/public --cleanDestinationDir --noBuildLock --renderSegments $(segments)
122125

123126
test-examples:
124127
scripts/test_examples.sh install

OWNERS_ALIASES

Lines changed: 16 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,27 @@
11
aliases:
22
sig-docs-blog-owners: # Approvers for blog content
3+
- lmktfy
4+
- graz-dev
35
- mrbobbytables
46
- natalisucks
57
- nate-double-u
6-
- sftim
78
sig-docs-blog-reviewers: # Reviewers for blog content
89
- Gauravpadam
10+
- graz-dev
11+
- lmktfy
912
- mrbobbytables
1013
- natalisucks
1114
- nate-double-u
12-
- sftim
1315
sig-docs-website-owners: # Admins for overall website
16+
- dipesh-rawat
1417
- divya-mohan0209
1518
- katcosgrove
19+
- lmktfy
1620
- natalisucks
1721
- nate-double-u
1822
- reylejano
1923
- salaxander
20-
- sftim
24+
- SayakMukhopadhyay
2125
- tengqm
2226
sig-docs-localization-owners: # Admins for localization content
2327
- a-mccarthy
@@ -26,7 +30,6 @@ aliases:
2630
- nate-double-u
2731
- reylejano
2832
- salaxander
29-
- sftim
3033
- seokho-son
3134
- tengqm
3235
sig-docs-localization-reviewers: # PR reviews for localization changes
@@ -36,7 +39,6 @@ aliases:
3639
- nate-double-u
3740
- reylejano
3841
- salaxander
39-
- sftim
4042
- seokho-son
4143
- tengqm
4244
sig-docs-bn-owners: # Admins for Bengali content
@@ -58,29 +60,27 @@ aliases:
5860
- dipesh-rawat
5961
- divya-mohan0209
6062
- katcosgrove
63+
- lmktfy
6164
- natalisucks
6265
- nate-double-u
63-
- rayandas # RT 1.33 Docs Lead
6466
- reylejano
6567
- salaxander
66-
- sftim
68+
- SayakMukhopadhyay
6769
- tengqm
6870
sig-docs-en-reviews: # PR reviews for English content
6971
- dipesh-rawat
7072
- divya-mohan0209
7173
- katcosgrove
72-
- kbhawkey
74+
- lmktfy
7375
- mengjiao-liu
7476
- natalisucks
7577
- nate-double-u
7678
- reylejano
7779
- salaxander
78-
- sftim
80+
- SayakMukhopadhyay
7981
- shannonxtreme
8082
- tengqm
8183
- windsonsea
82-
- Princesso
83-
- drewhagen
8484
sig-docs-es-owners: # Admins for Spanish content
8585
- electrocucaracha
8686
- krol3
@@ -107,15 +107,18 @@ aliases:
107107
- bishal7679
108108
- dipesh-rawat
109109
- divya-mohan0209
110+
- jayeshmahajan
110111
- niranjandarshann
111112
sig-docs-id-owners: # Admins for Indonesian content
112113
- ariscahyadi
113114
- girikuncoro
114115
- habibrosyad
116+
- za
115117
sig-docs-id-reviews: # PR reviews for Indonesian content
116118
- ariscahyadi
117119
- girikuncoro
118120
- habibrosyad
121+
- za
119122
sig-docs-it-owners: # Admins for Italian content
120123
- fabriziopandini
121124
- Fale
@@ -215,9 +218,11 @@ aliases:
215218
- mfilocha
216219
- nvtkaszpir
217220
sig-docs-uk-owners: # Admins for Ukrainian content
221+
- Andygol
218222
- Arhell
219223
- MaxymVlasov
220224
sig-docs-uk-reviews: # PR reviews for Ukrainian content
225+
- Andygol
221226
- Arhell
222227
- idvoretskyi
223228
- MaxymVlasov

README.md

Lines changed: 22 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -55,10 +55,20 @@ To build the site in a container, run the following:
5555

5656
```bash
5757
# You can set $CONTAINER_ENGINE to the name of any Docker-like container tool
58+
59+
# Render the full website
5860
make container-serve
61+
62+
# Render only a specific language segment (e.g., English)
63+
make container-serve segments=en
64+
65+
# Render multiple languages (e.g., English and Korean)
66+
make container-serve segments=en,ko
5967
```
6068

61-
If you see errors, it probably means that the hugo container did not have enough computing resources available. To solve it, increase the amount of allowed CPU and memory usage for Docker on your machine ([MacOS](https://docs.docker.com/desktop/settings/mac/) and [Windows](https://docs.docker.com/desktop/settings/windows/)).
69+
**💡 Tip:** Using _Hugo segments_ speeds up local preview builds, by rendering only selected language(s).
70+
71+
If you see errors, it probably means that the Hugo container did not have enough computing resources available. To solve it, increase the amount of allowed CPU and memory usage for Docker on your machine ([macOS](https://docs.docker.com/desktop/settings/mac/) and [Windows](https://docs.docker.com/desktop/settings/windows/)).
6272

6373
Open up your browser to <http://localhost:1313> to view the website. As you make changes to the source files, Hugo updates the website and forces a browser refresh.
6474

@@ -70,9 +80,19 @@ To install dependencies, deploy and test the site locally, run:
7080

7181
```bash
7282
npm ci
83+
84+
# Render the full site (default)
7385
make serve
86+
87+
# Render only a specific language segment
88+
make serve segments=en
89+
90+
# Render multiple language segments
91+
make serve segments=en,ko
7492
```
7593

94+
**💡 Tip:** Hugo segments are defined in `hugo.toml` and allow faster rendering by limiting the scope to specific language(s).
95+
7696
- For Windows (PowerShell)
7797

7898
```powershell
@@ -82,6 +102,7 @@ To install dependencies, deploy and test the site locally, run:
82102

83103
This will start the local Hugo server on port 1313. Open up your browser to <http://localhost:1313> to view the website. As you make changes to the source files, Hugo updates the website and forces a browser refresh.
84104

105+
85106
## Building the API reference pages
86107

87108
The API reference pages located in `content/en/docs/reference/kubernetes-api` are built from the Swagger specification, also known as OpenAPI specification, using <https://github.com/kubernetes-sigs/reference-docs/tree/master/gen-resourcesdocs>.

SECURITY_CONTACTS

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -11,11 +11,9 @@
1111
# INSTRUCTIONS AT https://kubernetes.io/security/
1212

1313
divya-mohan0209
14-
reylejano
15-
sftim
16-
tengqm
17-
onlydole
18-
kbhawkey
14+
katcosgrove
15+
lmktfy
1916
natalisucks
17+
reylejano
2018
salaxander
21-
katcosgrove
19+
tengqm

assets/images/OWNERS

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,13 +4,12 @@
44
# reviewers to review and approve.
55
# Teams and members are visible at https://github.com/orgs/kubernetes/teams.
66

7-
reviewers:
8-
- sig-docs-en-reviews
9-
10-
approvers:
11-
- sig-docs-en-owners
12-
137
filters:
8+
".*":
9+
reviewers:
10+
- sig-docs-en-reviews
11+
approvers:
12+
- sig-docs-en-owners
1413
"\\.svg":
1514
labels:
1615
- area/web-development
129 KB
Loading

assets/js/banner-dismiss.js

Lines changed: 38 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,45 +1,53 @@
1-
$(document).ready(function() {
2-
function setCookie(name, value, days) {
3-
let expires = "";
4-
let date = new Date(); // Create a new Date object
5-
let dateToSecond = 24 * 60 * 60 * 1000;
6-
7-
if (days) {
8-
date.setTime(date.getTime() + days * dateToSecond); // Modify the existing Date object
9-
expires = "; expires=" + date.toUTCString();
10-
}
11-
12-
document.cookie = name + "=" + value + expires + "; path=/";
13-
}
14-
15-
function getCookie(name) {
16-
let matches = document.cookie.match(new RegExp(
17-
"(?:^|; )" + name.replace(/([\.$?*|{}\(\)\[\]\\\/\+^])/g, '\\$1') + "=([^;]*)"
18-
));
19-
return matches ? "true" : undefined;
20-
}
21-
22-
/* Check the presence of a cookie */
23-
let announcement = document.querySelector("#announcement");
1+
$(document).ready(function() {
2+
function setCookie(name, value, days) {
3+
let expires = "";
4+
let date = new Date(); // Create a new Date object
5+
let dateToSecond = 24 * 60 * 60 * 1000;
6+
7+
if (days) {
8+
date.setTime(date.getTime() + days * dateToSecond); // Modify the existing Date object
9+
expires = "; expires=" + date.toUTCString();
10+
}
11+
12+
document.cookie = name + "=" + value + expires + "; path=/";
13+
}
14+
15+
function getCookie(name) {
16+
let matches = document.cookie.match(new RegExp(
17+
"(?:^|; )" + name.replace(/([\.$?*|{}\(\)\[\]\\\/\+^])/g, '\\$1') + "=([^;]*)"
18+
));
19+
return matches ? "true" : undefined;
20+
}
21+
22+
function getTokenName() {
23+
let announcement_name_rewritten = announcement.getAttribute('data-announcement-name').replace(/\s/g, '_');
24+
let token = 'announcement_ack_'+announcement_name_rewritten; // Generate the unique token for this announcement
25+
return token;
26+
}
27+
28+
/* Check the presence of a cookie */
29+
let announcement = document.querySelector("#announcement");
2430
if (announcement) {
25-
let token = `announcement_ack_${announcement.getAttribute('data-announcement-name').replace(/\s/g, '_')}`; // Generate the unique token for announcement
26-
let acknowledged = getCookie(token);
31+
let announcement_name_rewritten = announcement.getAttribute('data-announcement-name').replace(/\s/g, '_');
32+
let tokenName = getTokenName();
33+
let acknowledged = getCookie(tokenName);
2734
if (acknowledged === "true") {
2835
announcement.remove(); // Remove the announcement if the cookie is set
2936
}
3037
else {
3138
announcement.classList.add('display-announcement') // Display the announcement if the cookie is not set
3239
}
3340
}
34-
35-
/* Driver code to set the cookie */
36-
let button = document.querySelector('#banner-dismiss');
41+
42+
/* Driver code to set the cookie */
43+
let button = document.querySelector('#banner-dismiss');
3744
if (button) {
45+
let tokenName = getTokenName();
3846
button.removeAttribute('style');
3947
button.addEventListener('click', function() {
40-
setCookie(token, "true",
48+
setCookie(tokenName, "true",
4149
button.getAttribute('data-ttl')); // Set a cookie with time to live parameter
4250
announcement.remove();
4351
});
4452
}
45-
});
53+
});
File renamed without changes.

assets/js/sidebar-tree.js

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
let splitInstance = null;
2+
3+
function enableSplitter(mediaQuery) {
4+
if (mediaQuery.matches) {
5+
if (!splitInstance) {
6+
splitInstance = Split(["#sidebarnav", "#maindoc"], {
7+
sizes: [20, 80],
8+
minSize: 100,
9+
});
10+
}
11+
} else {
12+
if (splitInstance) {
13+
splitInstance.destroy();
14+
splitInstance = null;
15+
}
16+
}
17+
}
18+
19+
const screenWidthMediaQuery = window.matchMedia("(min-width: 768px)");
20+
21+
const eleNav = document.getElementById("sidebarnav");
22+
if (eleNav !== null) {
23+
enableSplitter(screenWidthMediaQuery);
24+
screenWidthMediaQuery.addListener(enableSplitter);
25+
}

0 commit comments

Comments
 (0)