bigheader: "Reference Documentation"
abstract: "Design docs, concept definitions, and references for APIs and CLIs."
toc:
- docs/reference/index.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

- title: API Reference
  section:
  - title: v1.7
    path: /docs/api-reference/v1.7/
  - title: v1.6
    path: /docs/api-reference/v1.6/
  - title: v1.5
    path: /docs/api-reference/v1.5/
  - 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/federation/v1/operations.html
    - docs/reference/federation/v1/definitions.html
    - docs/reference/federation/v1beta1/operations.html
    - docs/reference/federation/v1beta1/definitions.html
    - docs/reference/federation/extensions/v1beta1/operations.html
    - docs/reference/federation/extensions/v1beta1/definitions.html

- title: kubectl CLI
  section:
  - docs/user-guide/kubectl-overview.md
  - title: v1.7 Commands
    path: /docs/user-guide/kubectl/v1.7/
  - title: v1.6 Commands
    path: /docs/user-guide/kubectl/v1.6/
  - title: v1.5 Commands
    path: /docs/user-guide/kubectl/v1.5/
  - docs/user-guide/docker-cli-to-kubectl.md
  - docs/user-guide/kubectl-conventions.md
  - docs/user-guide/jsonpath.md
  - docs/user-guide/kubectl-cheatsheet.md

- title: Setup Tools
  section:
  - title: Kubeadm
    path: /docs/admin/kubeadm/
  - title: Kubefed
    path: /docs/admin/kubefed/
    section:
    - docs/admin/kubefed.md
    - docs/admin/kubefed_options.md
    - docs/admin/kubefed_init.md
    - docs/admin/kubefed_join.md
    - docs/admin/kubefed_unjoin.md
    - docs/admin/kubefed_version.md

- title: Config Reference
  section:
  - docs/admin/kubelet.md
  - docs/admin/kube-apiserver.md
  - docs/admin/kube-controller-manager.md
  - docs/admin/kube-proxy.md
  - docs/admin/kube-scheduler.md
  - docs/admin/federation-apiserver.md
  - docs/admin/federation-controller-manager.md

- title: Kubernetes Design Docs
  section:
  - title: Kubernetes Architecture
    path: https://git.k8s.io/community/contributors/design-proposals/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/access.md
  - docs/admin/ovs-networking.md
  - title: Security Contexts
    path: https://git.k8s.io/community/contributors/design-proposals/security_context.md
  - title: Security in Kubernetes
    path: https://git.k8s.io/community/contributors/design-proposals/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