kubernetes
/
examples
mirror of https://github.com/kubernetes/examples.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #8 from nikhita/fix-links-guidelines 

Fix links in guidelines
This commit is contained in:
sebgoa 2017-06-13 10:54:21 +02:00 committed by GitHub
parent f210d24ff2 15e88c6490
commit 7fa13630d5
1 changed files with 13 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
guidelines.md
View File

@ -10,7 +10,7 @@ Examples are not:
* Full app deployments, ready to use, with no explanation. These * Full app deployments, ready to use, with no explanation. These
belong to [Helm charts](https://github.com/kubernetes/charts). belong to [Helm charts](https://github.com/kubernetes/charts).
* Simple toys to show how to use a Kubernetes feature. These belong in * Simple toys to show how to use a Kubernetes feature. These belong in
the [user guide](../docs/user-guide/). the [user guide](https://kubernetes.io/docs/home/).
* Demos that follow a script to show a Kubernetes feature in * Demos that follow a script to show a Kubernetes feature in
action. Example: killing a node to demonstrate controller action. Example: killing a node to demonstrate controller
self-healing. self-healing.
@ -28,8 +28,8 @@ Examples are not:
commands (TL;DR / quickstart), without cloning the repo (kubectl commands (TL;DR / quickstart), without cloning the repo (kubectl
apply -f http://...). apply -f http://...).
* Points to documentation of prerequisites. * Points to documentation of prerequisites.
* [Create a cluster](../docs/getting-started-guides/) (e.g., single-node docker). * [Create a cluster](https://github.com/kubernetes/community/tree/master/contributors/devel/local-cluster) (e.g., single-node docker).
* [Setup kubectl](../docs/user-guide/prereqs.md). * [Setup kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/).
* etc. * etc.
* Should specify which release of Kubernetes is required and any other * Should specify which release of Kubernetes is required and any other
prerequisites, such as DNS, a cloudprovider with PV provisioning, a prerequisites, such as DNS, a cloudprovider with PV provisioning, a
@ -42,21 +42,21 @@ Examples are not:
### Throughout ### Throughout
* Should point to documentation on first mention: * Should point to documentation on first mention:
[kubectl](../docs/user-guide/kubectl-overview.md), [kubectl](https://kubernetes.io/docs/user-guide/kubectl-overview/),
[pods](../docs/user-guide/pods.md), [pods](https://kubernetes.io/docs/concepts/workloads/pods/pod/),
[services](../docs/user-guide/services.md), [services](https://kubernetes.io/docs/concepts/services-networking/service/),
[deployments](../docs/user-guide/deployments.md), [deployments](https://kubernetes.io/docs/concepts/workloads/controllers/deployment/),
[replication controllers](../docs/user-guide/replication-controller.md), [replication controllers](https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller/),
[jobs](../docs/user-guide/jobs.md), [jobs](https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/),
[labels](../docs/user-guide/labels.md), [labels](https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/),
[persistent volumes](../docs/user-guide/persistent-volumes.md), [persistent volumes](https://kubernetes.io/docs/concepts/storage/persistent-volumes/),
etc. etc.
* Most examples should be cloudprovider-independent (e.g., using PVCs, not PDs). * Most examples should be cloudprovider-independent (e.g., using PVCs, not PDs).
* Other examples with cloudprovider-specific bits could be somewhere else. * Other examples with cloudprovider-specific bits could be somewhere else.
* Actually show the app working -- console output, and or screenshots. * Actually show the app working -- console output, and or screenshots.
* Ascii animations and screencasts are recommended. * Ascii animations and screencasts are recommended.
* Follows [config best practices](../docs/user-guide/config-best-practices.md). * Follows [config best practices](https://kubernetes.io/docs/concepts/configuration/overview/).
* Shouldn't duplicate the [thorough walk-through](../docs/user-guide/#thorough-walkthrough). * Shouldn't duplicate the [user guide](https://kubernetes.io/docs/home/).
* Docker images are pre-built, and source is contained in a subfolder. * Docker images are pre-built, and source is contained in a subfolder.
* Source is the Dockerfile and any custom files needed beyond the * Source is the Dockerfile and any custom files needed beyond the
upstream app being packaged. upstream app being packaged.