Skip to content

Commit 3c54edf

Browse files
committed
add merged npeps to website
This will help us keep track and spread awareness in reguards to in process work items. Signed-off-by: astoycos <[email protected]>
1 parent 90b6d38 commit 3c54edf

File tree

5 files changed

+43
-20
lines changed

5 files changed

+43
-20
lines changed
823 Bytes
Binary file not shown.

hack/mkdocs-copy-npeps.py

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
# Copyright 2023 The Kubernetes Authors.
2+
#
3+
# Licensed under the Apache License, Version 2.0 (the "License");
4+
# you may not use this file except in compliance with the License.
5+
# You may obtain a copy of the License at
6+
#
7+
# http://www.apache.org/licenses/LICENSE-2.0
8+
#
9+
# Unless required by applicable law or agreed to in writing, software
10+
# distributed under the License is distributed on an "AS IS" BASIS,
11+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12+
# See the License for the specific language governing permissions and
13+
# limitations under the License.
14+
15+
import shutil
16+
import logging
17+
from mkdocs import plugins
18+
19+
log = logging.getLogger('mkdocs')
20+
21+
@plugins.event_priority(100)
22+
def on_pre_build(config, **kwargs):
23+
log.info("copying npeps")
24+
shutil.copytree("npeps","site-src/npeps", dirs_exist_ok=True)

mkdocs.yml

Lines changed: 14 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,10 @@ repo_url: https://github.com/kubernetes-sigs/network-policy-api
33
repo_name: kubernetes-sigs/network-policy-api
44
site_dir: site
55
docs_dir: site-src
6+
hooks:
7+
- hack/mkdocs-copy-npeps.py
8+
watch:
9+
- npeps
610
theme:
711
name: material
812
icon:
@@ -48,19 +52,13 @@ nav:
4852
- Reference:
4953
- Examples: reference/examples.md
5054
- API Reference: reference/spec.md
51-
- Enhancement Proposals: enhancements.md
52-
53-
54-
# (TODO)
55-
# - Implementation Guidelines: concepts/guidelines.md
56-
# - Versioning: concepts/versioning.md
57-
# - Implementations: implementations.md
58-
# - FAQ: faq.md
59-
# - Guides:
60-
# - Getting started: guides/getting-started.md
61-
# - Contributing:
62-
# - Developer guide: contributing/devguide.md
63-
# - Enhancement Tracking and Backlog: contributing/enhancement-requests.md
64-
# - Community: contributing/community.md
65-
# - Blog:
66-
# - Index: blog/index.md
55+
- Enhancement Proposals:
56+
- Overview: enhancements.md
57+
- Template: npeps/npep-95.md
58+
- Provisional:
59+
- npeps/npep-126-egress-traffic-control.md
60+
- Implementable:
61+
- npeps/npep-137-conformance-profiles.md
62+
# - Experimental:
63+
# - Standard:
64+
# - Declined:

requirements.txt

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
Click==7.0
22
htmlmin==0.1.12
3-
Jinja2==2.11.1
3+
Jinja2==3.1.2
44
jsmin==3.0.0
55
livereload==2.6.1
66
Markdown==3.3.4
7-
MarkupSafe==1.1.1
8-
mkdocs==1.2.2
7+
MarkupSafe==2.1.3
8+
mkdocs==1.5.2
99
mkdocs-awesome-pages-plugin==2.7.0
1010
mkdocs-macros-plugin==0.6.0
1111
mkdocs-material==7.3.3

site-src/enhancements.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,8 @@ NPEP process is supposed to be iterative, adding more details with every iterati
5555
To start NPEP process, create a PR adding `npep-<issue number>.md` file in the
5656
[npep folder](https://github.com/kubernetes-sigs/network-policy-api/tree/master/npep)
5757
using the [template NPEP](https://github.com/kubernetes-sigs/network-policy-api/blob/master/npep/npep-95.md) as a
58-
starting point.
58+
starting point. Make sure to also add your new NPEP to the website, this can be done within
59+
the `index.md` file at the root of the repo.
5960

6061
### 4. Provisional: Agree on the Goals and applicable User-Stories
6162

0 commit comments

Comments
 (0)