bigheader: "Reference Documentation"
abstract: "Design docs, concept definitions, and references for APIs and CLIs."
toc:
- docs/reference/index.md
- docs/reference/glossary.md

- title: Using the API
  section:
  - docs/reference/api-overview.md
  - docs/reference/client-libraries.md
  - title: Accessing the API
    section:
    - docs/admin/accessing-the-api.md
    - docs/admin/authentication.md
    - docs/admin/bootstrap-tokens.md
    - docs/admin/admission-controllers.md
    - docs/admin/extensible-admission-controllers.md
    - docs/admin/service-accounts-admin.md
  - title: Authorization
    section:
    - docs/admin/authorization/index.md
    - docs/admin/authorization/abac.md
    - docs/admin/authorization/rbac.md
    - docs/admin/authorization/node.md
    - docs/admin/authorization/webhook.md
  - docs/reference/deprecation-policy.md
  - docs/reference/workloads-18-19.md

- title: API Reference
  section:
  - title: v1.9
    path: /docs/reference/generated/kubernetes-api/v1.9/
  - docs/reference/labels-annotations-taints.md
  - title: OpenAPI and Swagger
    section:
    - title: OpenAPI Spec
      path: https://git.k8s.io/kubernetes/api/openapi-spec/
    - title: Swagger Spec
      path: https://git.k8s.io/kubernetes/api/swagger-spec/

- title: Federation API
  section:
    - docs/reference/generated/federation/v1/operations.html
    - docs/reference/generated/federation/v1/definitions.html
    - docs/reference/generated/federation/extensions/v1beta1/operations.html
    - docs/reference/generated/federation/extensions/v1beta1/definitions.html

- title: kubectl CLI
  section:
  - docs/reference/kubectl/overview.md
  - docs/reference/generated/kubectl/kubectl.md
  - title: kubectl Commands
    path: /docs/reference/generated/kubectl/kubectl-commands.html
  - docs/reference/kubectl/docker-cli-to-kubectl.md
  - docs/reference/kubectl/conventions.md
  - docs/reference/kubectl/jsonpath.md
  - docs/reference/kubectl/cheatsheet.md

- title: Setup Tools Reference
  section:
  - title: Kubeadm
    section:
    - docs/reference/setup-tools/kubeadm/kubeadm.md
    - docs/reference/setup-tools/kubeadm/kubeadm-init.md
    - docs/reference/setup-tools/kubeadm/kubeadm-join.md
    - docs/reference/setup-tools/kubeadm/kubeadm-upgrade.md
    - docs/reference/setup-tools/kubeadm/kubeadm-config.md
    - docs/reference/setup-tools/kubeadm/kubeadm-reset.md
    - docs/reference/setup-tools/kubeadm/kubeadm-token.md
    - docs/reference/setup-tools/kubeadm/kubeadm-version.md
    - docs/reference/setup-tools/kubeadm/kubeadm-alpha.md 
    - docs/reference/setup-tools/kubeadm/implementation-details.md 
  - title: Kubefed
    section:
    - docs/reference/generated/kubefed.md
    - docs/reference/generated/kubefed_options.md
    - docs/reference/generated/kubefed_init.md
    - docs/reference/generated/kubefed_join.md
    - docs/reference/generated/kubefed_unjoin.md
    - docs/reference/generated/kubefed_version.md

- title: Command-line Tools Reference
  section:
  - docs/reference/generated/kubelet.md
  - docs/admin/kubelet-authentication-authorization.md
  - docs/reference/generated/kube-apiserver.md
  - docs/reference/generated/kube-controller-manager.md
  - docs/reference/generated/kube-proxy.md
  - docs/reference/generated/kube-scheduler.md
  - docs/admin/kubelet-tls-bootstrapping.md
  - docs/reference/generated/cloud-controller-manager.md
  - docs/reference/generated/federation-apiserver.md
  - docs/reference/generated/federation-controller-manager.md

- title: Kubernetes Design Docs
  section:
  - title: Kubernetes Architecture
    path: https://git.k8s.io/community/contributors/design-proposals/architecture/architecture.md
  - title: Kubernetes Design Overview
    path: https://github.com/kubernetes/kubernetes/tree/release-1.6/docs/design
  - title: Kubernetes Identity and Access Management
    path: https://git.k8s.io/community/contributors/design-proposals/auth/access.md
  - docs/admin/ovs-networking.md
  - title: Security Contexts
    path: https://git.k8s.io/community/contributors/design-proposals/auth/security_context.md
  - title: Security in Kubernetes
    path: https://git.k8s.io/community/contributors/design-proposals/auth/security.md

- title: Kubernetes Issues and Security
  section:
  - title: Kubernetes Issue Tracker on GitHub
    path: https://github.com/kubernetes/kubernetes/issues/
  - docs/reference/security.md