Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
5701c13
test
CsatariGergely Jan 23, 2024
c16379a
Fixing broken links in resources.md
CsatariGergely Jan 23, 2024
531766b
Fixing broken links in README.md
CsatariGergely Jan 23, 2024
b76ff9f
Fixing broken links in the main page and glossary
CsatariGergely Jan 23, 2024
ac12dd8
Add linkspector config file
CsatariGergely Jan 23, 2024
95bbf8b
Fixing links in glossary
CsatariGergely Jan 23, 2024
a1ff018
Adjusing line lenghts in glossary.md
CsatariGergely Jan 23, 2024
61f6a0a
Still tryig to fix the DRY wikipedia ling
CsatariGergely Jan 24, 2024
3c0c29c
Testing wikipedia links
CsatariGergely Jan 24, 2024
d7e5933
Removal of wiki test
CsatariGergely Jan 24, 2024
85f43da
Add verification for the linkspector config file
CsatariGergely Jan 23, 2024
77f5de5
Ignoring localhost links
CsatariGergely Jan 24, 2024
0ff25d4
Fixing links in learning.md
CsatariGergely Jan 24, 2024
56da28b
Merge branch 'add-linkcheck' into test
CsatariGergely Jan 24, 2024
28b86ec
Fixing links
CsatariGergely Jan 24, 2024
76adee8
Adding HOSTNAME to the ignore list
CsatariGergely Jan 24, 2024
a4234cd
Fixing OKTA link
CsatariGergely Jan 24, 2024
c44ba26
Fixing broken links
CsatariGergely Jan 24, 2024
e9cd981
Another attempt to fix the wiki link
CsatariGergely Jan 24, 2024
17549ad
test
CsatariGergely Jan 25, 2024
07a9078
Merge branch 'add-linkcheck' into test
CsatariGergely Jan 25, 2024
d12ccd1
Tryig to fix the wikipedia link
CsatariGergely Jan 25, 2024
2d63b8a
Fixing broken links in glossary
CsatariGergely Jan 25, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .linkspector.yml
Original file line number Diff line number Diff line change
Expand Up @@ -10,4 +10,4 @@ aliveStatusCodes:
ignorePatterns:
- pattern: "^http://localhost.*$"
- pattern: "^http://HOSTNAME:PORT.*$"
- pattern: "^http.*t_repeat_yourself#WET.*"
- pattern: "^http.*t_repeat_yourself#WET.*"
10 changes: 5 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,15 +36,15 @@ includes a [demo video](https://youtu.be/mFl71sy2Pdc) and short articles about
different aspects of R1.

## User Documentation
* [Release Notes](https://github.com/nephio-project/docs/blob/main/release-notes/README.md)
* [Demo Sandbox Environment Installation](https://github.com/nephio-project/docs/blob/main/install-guide/README.md)
* [Quick Start Exercises](https://github.com/nephio-project/docs/blob/main/user-guide/exercises.md)
* [User Guide](https://github.com/nephio-project/docs/blob/main/user-guide/README.md)
* [Release Notes](/content/en/docs/release-notes)
* [Demo Sandbox Environment Installation](/content/en/docs/guides/install-guides/_index.md)
* [Quick Start Exercises](/content/en/docs/guides/user-guides/exercises.md)
* [User Guide](/content/en/docs/guides/user-guides/_index.md)

## Other Documentation

* [Developer Documentation](https://github.com/nephio-project/nephio)
* [Developer Guide](https://github.com/nephio-project/docs/blob/main/developer-guide/README.md)
* [Developer Guide](/content/en/docs/guides/contributor-guides/_index.md)
* [Project Resources](https://github.com/nephio-project/docs/blob/main/resources.md)

## About Nephio R1
Expand Down
6 changes: 3 additions & 3 deletions content/en/_index.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Start
description: Documentation of the Nephio project
description: Documentation of the Nephio project test1
menu: {main: {weight: 10}}
---
{{< blocks/cover title="Welcome to the Nephio documentation" image_anchor="top" height="full" >}}
Expand All @@ -22,7 +22,7 @@ menu: {main: {weight: 10}}
{{% blocks/lead color="primary" %}}
[Nephio project's](https://nephio.org) mission is "to deliver carrier-grade, simple, open, Kubernetes-based cloud native intent automation and
common automation templates that materially simplify the deployment and management of multi-vendor cloud infrastructure
and network functions across large scale edge deployments."
and network functions across large scale edge deployments."
{{% /blocks/lead %}}

{{% blocks/section type="row" %}}
Expand All @@ -38,7 +38,7 @@ Mass amount of developer inofrmation is available in the [wiki](https://wiki.nep
{{% /blocks/feature %}}

{{% blocks/feature icon="fas fa-balance-scale-right" title="Charter" %}}
Technical charter of the project can be found [here](https://nephio.org/wp-content/uploads/sites/6/2022/06/Nephio-Project-Technical-Charter-Amended-6-9-2022.pdf).
Technical charter of the project can be found [here](https://github.com/nephio-project/governance/blob/main/nephio-technical-charter-amended-2022-06-22.pdf).
{{% /blocks/feature %}}


Expand Down
21 changes: 15 additions & 6 deletions content/en/docs/glossary.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,15 +28,20 @@ vendors enable KRM-based management of this internal configuration, to allow
leveraging all the techniques we are building for KRM-based configuration (this
is part of the "Kubernetes Everywhere" principle).

As a community, we should try to use a common set of terminology for different
types of configuration. See
[docs#4](https://github.com/nephio-project/docs/issues/4).
As a community, we should try to use a common set of terminology for different types of configuration. See
[docs#4](https://github.com/nephio-project/nephio/issues/266).

## Config Injection
See [Injector](#injector).

## Controller
This term comes from Kubernetes where [controller](https://kubernetes.io/docs/reference/glossary/?fundamental=true#term-controller) is defined as a control loop that watches the intended and actual state of the cluster, and attempts to make changes as needed to make the actual state match the intended state. More specifically, this typically refers to software that processes Kubernetes Resources residing in the Kubernetes API server, and either transforms them into new resources, or calls to other APIs that change the state of some entity external to the API server. For example, `kubelet` itself is a controller that processes Pod resources to create and manage containers on a Node.
This term comes from Kubernetes where
[controller](https://kubernetes.io/docs/reference/glossary/?fundamental=true#term-controller) is defined as a control
loop that watches the intended and actual state of the cluster, and attempts to make changes as needed to make the
actual state match the intended state. More specifically, this typically refers to software that processes Kubernetes
Resources residing in the Kubernetes API server, and either transforms them into new resources, or calls to other APIs
that change the state of some entity external to the API server. For example, `kubelet` itself is a controller that
processes Pod resources to create and manage containers on a Node.

*See also*: [Operator](#operator), [Injector](#injector), [KRM
function](#krm-function), [Specializer](#specializer)
Expand Down Expand Up @@ -339,8 +344,12 @@ we may build new types of variant generators, and may even compose them (for
example, to produce variants that are affected by both environment and cluster).

## WET
This term, which we use as an acronym for "Write Every Time", comes from [software
engineering](https://en.wikipedia.org/wiki/Don%27t_repeat_yourself#WET), and is a somewhat pejorative term in contrast to [DRY](#dry). However, in the context of *configuration-as-data*, rather than *code*, the idea of storing the configuration as fully-formed data enables automation and the use of data-management techniques to manage the configuration at scale.

This term, which we use as an acronym for "Write Every Time", comes from
[software engineering](https://en.wikipedia.org/wiki/Don%27t_repeat_yourself), and is a somewhat pejorative term in
contrast to [DRY](#dry). However, in the context of *configuration-as-data*, rather than *code*, the idea of storing the
configuration as fully-formed data enables automation and the use of data-management techniques to manage the
configuration at scale.

*See also*: [DRY](#dry), [Hydration](#hydration)

Expand Down
10 changes: 5 additions & 5 deletions content/en/docs/guides/install-guides/install-on-byoc.md
Original file line number Diff line number Diff line change
Expand Up @@ -115,11 +115,11 @@ Flux or ArgoCD to apply packages to the clusters.
R1 uses Cluster API, but other options may be used such as Crossplane, Google
KCC, or AWS Controllers for Kubernetes. You can provision more than one.

| Provider | Notes |
| --------------------------- | --------------------------------------------------------------------------------------- |
| [Cluster API](capi.md) | Kubernetes project cluster provisioner for a variety of cluster providers. |
| [KCC](kcc.md) | Google's Kubernetes Config Connector for GKE clusters and other GCP resources. |
| [Crossplane](crossplane.md) | API composition framework with cluster and other infrastructure providers. |
| Provider | Notes |
| ----------- | --------------------------------------------------------------------------------------- |
| Cluster API | Kubernetes project cluster provisioner for a variety of cluster providers. |
| KCC | Google's Kubernetes Config Connector for GKE clusters and other GCP resources. |
| Crossplane | API composition framework with cluster and other infrastructure providers. |

### Load Balancer

Expand Down
2 changes: 1 addition & 1 deletion content/en/docs/guides/install-guides/webui-auth-okta.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ In the secret, use these keys:
| -------------- | ----------------------------------------------------------- |
| client-id | The client ID that you generated on Okta, e.g. 3abe134ejxzF21HU74c1 |
| client-secret | The client secret shown for the Application. |
| audience | The Okta domain shown for the Application, e.g. https://company.okta.com |
| audience | The Okta domain shown for the Application, e.g. https://www.okta.com/company/ |
| auth-server-id | The authorization server ID for the Application (optional) |
| idp | The identity provider for the application, e.g. 0oaulob4BFVa4zQvt0g3 (optional) |

Expand Down
7 changes: 3 additions & 4 deletions content/en/docs/guides/user-guides/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -329,12 +329,11 @@ The diagram below depicts deployment at the high level.
## Troubleshooting and Workarounds

On the demo VM, the `test-infra/e2e/provision/hacks` directory contains some
workaround scripts. Also, please see the Release Notes [known
issues](../../release-notes/r1#known-issues-and-workarounds).
workaround scripts. Also, please see the Release Notes
[known issues]({{< relref "../release-notes/r1#known-issues-and-workarounds">}}).

## Next Steps

* Learn more about the Nephio
[controllers](https://github.com/nephio-project/docs/blob/main/user-guide/controllers.md)
* Learn more about the Nephio [controllers]({{< relref "controllers.md">}})
* Learn more about how packages are [transformed]({{< relref "../install-guides/package-transformations.md" >}})
* Learn more about [deploying helm charts]({{< relref "../user-guides/helm/#helm-integration-in-nephio" >}}) in Nephio
1 change: 0 additions & 1 deletion learning.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,6 @@
* [Build a Kubernetes Operator in Six Steps](https://developers.redhat.com/articles/2021/09/07/build-kubernetes-operator-six-steps): Howto article from Red Hat
* [How to Build a Kubernetes Operator](https://www.techtarget.com/searchitoperations/tutorial/How-to-build-a-Kubernetes-operator): Howto article from TechTarget
* [Kopf: Kubernetes Operators Framework](https://kopf.readthedocs.io/en/stable/): A framework for writing Kubernetes Operators in python
* [Creating Custom Resources in Kubernetes 1](https://www.pluralsight.com/courses/kubernetes-creating-custom-resources): Subscription required (with initial free trial) but helpful for writing CR/CRD/Operators

## KPT

Expand Down
4 changes: 2 additions & 2 deletions resources.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ More tutorials are under discussion in
* [SIG Release Meeting playlist](https://www.youtube.com/playlist?list=PLiW9_IXAWtks9Ys4Zs6wPRNEuQYAnWcg1)

## Other Resources
* The [Glossary](glossary.md) defines common terminology used in the Nephio
* The [Glossary](content/en/docs/glossary.md) defines common terminology used in the Nephio
project.
* The [Nephio Learning Resources page](learning.md) lists some learning resources that are useful for the Nephio community
* The [Abbreviation Decoder page](abbreviations.md) explains common abbreviations used in the project.
* The [Abbreviation Decoder page](content/en/docs/abbreviations.md) explains common abbreviations used in the project.