add explicit titles to docs

docs/user-guide/accessing-the-cluster.md

@@ -1,10 +1,10 @@
----
-assignees:
-- lavalamp
-- mikedanese
-
----
-
+---
+assignees:
+- lavalamp
+- mikedanese
+title: Accessing Clusters
+---
+
 * TOC
 {:toc}
 

docs/user-guide/annotations.md

@@ -2,7 +2,7 @@
 assignees:
 - mikedanese
 - thockin
-
+title: Annotations
 ---
 
 We have [labels](/docs/user-guide/labels) for identifying metadata.

docs/user-guide/application-troubleshooting.md

@@ -2,7 +2,7 @@
 assignees:
 - mikedanese
 - thockin
-
+title: Troubleshooting Applications
 ---
 
 This guide is to help users debug applications that are deployed into Kubernetes and not behaving correctly.

docs/user-guide/compute-resources.md

@@ -2,7 +2,7 @@
 assignees:
 - mikedanese
 - thockin
-
+title: Managing Compute Resources
 ---
 
 * TOC

docs/user-guide/config-best-practices.md

@@ -1,7 +1,7 @@
 ---
 assignees:
 - mikedanese
-
+title: Best Practices for Configuration
 ---
 
 This document is meant to highlight and consolidate in one place configuration best practices that are introduced throughout the user-guide and getting-started documentation and examples. This is a living document so if you think of something that is not on this list but might be useful to others, please don't hesitate to file an issue or submit a PR.

docs/user-guide/configmap/index.md

@@ -2,8 +2,9 @@
 assignees:
 - eparis
 - pmorie
-
+title: Using ConfigMap
 ---
+
 Many applications require configuration via some combination of config files, command line
 arguments, and environment variables.  These configuration artifacts should be decoupled from image
 content in order to keep containerized applications portable.  The ConfigMap API resource provides

docs/user-guide/configuring-containers.md

@@ -2,7 +2,7 @@
 assignees:
 - caesarxuchao
 - thockin
-
+title: Configuring Containers
 ---
 
 * TOC

docs/user-guide/connecting-applications.md

@@ -3,7 +3,7 @@ assignees:
 - caesarxuchao
 - lavalamp
 - thockin
-
+title: Connecting Applications with Services
 ---
 
 * TOC

docs/user-guide/connecting-to-applications-port-forward.md

@@ -2,7 +2,7 @@
 assignees:
 - caesarxuchao
 - mikedanese
-
+title: Connect with Port Forwarding
 ---
 
 kubectl port-forward forwards connections to a local port to a port on a pod. Its man page is available [here](/docs/user-guide/kubectl/kubectl_port-forward). Compared to [kubectl proxy](/docs/user-guide/accessing-the-cluster/#using-kubectl-proxy), `kubectl port-forward` is more generic as it can forward TCP traffic while `kubectl proxy` can only forward HTTP traffic. This guide demonstrates how to use `kubectl port-forward` to connect to a Redis database, which may be useful for database debugging.

docs/user-guide/connecting-to-applications-proxy.md

@@ -2,7 +2,7 @@
 assignees:
 - caesarxuchao
 - lavalamp
-
+title: Connect with Proxies
 ---
 
 You have seen the [basics](/docs/user-guide/accessing-the-cluster) about `kubectl proxy` and `apiserver proxy`. This guide shows how to use them together to access a service([kube-ui](/docs/user-guide/ui)) running on the Kubernetes cluster from your workstation.

docs/user-guide/container-environment.md

@@ -2,7 +2,7 @@
 assignees:
 - mikedanese
 - thockin
-
+title: Container Lifecycle Hooks
 ---
 
 This document describes the environment for Kubelet managed containers on a Kubernetes node (kNode).  In contrast to the Kubernetes cluster API, which provides an API for creating and managing containers, the Kubernetes container environment provides the container access to information about what else is going on in the cluster.

docs/user-guide/containers.md

@@ -1,7 +1,7 @@
 ---
 assignees:
 - mikedanese
-
+title: Commands and Capabilities
 ---
 
 * TOC

docs/user-guide/cron-jobs.md

@@ -3,7 +3,7 @@ assignees:
 - erictune
 - soltysh
 - janetkuo
-
+title: Cron Jobs
 ---
 
 * TOC

docs/user-guide/debugging-pods-and-replication-controllers.md

@@ -1,7 +1,7 @@
 ---
 assignees:
 - bprashanth
-
+title: Debugging Pods and Replication Controllers
 ---
 
 * TOC

docs/user-guide/debugging-services.md

@@ -3,7 +3,7 @@ assignees:
 - bprashanth
 - janetkuo
 - thockin
-
+title: Debugging Services
 ---
 
 An issue that comes up rather frequently for new installations of Kubernetes is

docs/user-guide/deploying-applications.md

@@ -3,10 +3,9 @@ assignees:
 - bgrant0607
 - caesarxuchao
 - thockin
-
+title: Deploying Applications
 ---
 
-
 * TOC
 {:toc}
 

docs/user-guide/deployments.md

@@ -2,7 +2,7 @@
 assignees:
 - bgrant0607
 - janetkuo
-
+title: Deployments
 ---
 
 * TOC

docs/user-guide/docker-cli-to-kubectl.md

@@ -3,7 +3,7 @@ assignees:
 - bgrant0607
 - brendandburns
 - thockin
-
+title: kubectl for Docker Users
 ---
 
 In this doc, we introduce the Kubernetes command line for interacting with the api to docker-cli users. The tool, kubectl, is designed to be familiar to docker-cli users but there are a few necessary differences. Each section of this doc highlights a docker subcommand explains the kubectl equivalent.

docs/user-guide/downward-api/index.md

@@ -2,7 +2,7 @@
 assignees:
 - bgrant0607
 - mikedanese
-
+title: Using the Downward API to Convey Pod Properties
 ---
 
 It is sometimes useful for a container to have information about itself, but we

docs/user-guide/downward-api/volume/index.md

@@ -1,4 +1,5 @@
 ---
+title: Downward API Volumes
 ---
 
 Following this example, you will create a pod with a downward API volume.

docs/user-guide/environment-guide/index.md

@@ -1,9 +1,9 @@
----
-assignees:
-- mikedanese
-
----
-
+---
+assignees:
+- mikedanese
+title: Using Environment Variables
+---
+
 This example demonstrates running pods, replication controllers, and
 services. It shows two types of pods: frontend and backend, with
 services on top of both. Accessing the frontend pod will return

docs/user-guide/federation/configmap.md

@@ -1,4 +1,5 @@
 ---
+title: Federated ConfigMap
 ---
 
 This guide explains how to use ConfigMaps in a Federation control plane.

docs/user-guide/federation/daemonsets.md

@@ -1,4 +1,5 @@
 ---
+title: Federated DaemonSet
 ---
 
 This guide explains how to use DaemonSets in a federation control plane.

docs/user-guide/federation/deployment.md

@@ -1,4 +1,5 @@
 ---
+title: Federated Deployment
 ---
 
 This guide explains how to use Deployments in the Federation control plane.

docs/user-guide/federation/events.md

@@ -1,4 +1,5 @@
 ---
+title: Federated Events
 ---
 
 This guide explains how to use events in federation control plane to help in debugging.

docs/user-guide/federation/federated-ingress.md

@@ -1,4 +1,5 @@
 ---
+title: Federated Ingress
 ---
 
 This guide explains how to use Kubernetes Federated Ingress to deploy

docs/user-guide/federation/federated-services.md

@@ -2,7 +2,7 @@
 assignees:
 - bprashanth
 - quinton-hoole
-
+title: Cross-cluster Service Discovery using Federated Services
 ---
 
 This guide explains how to use Kubernetes Federated Services to deploy

docs/user-guide/federation/index.md

@@ -1,4 +1,5 @@
 ---
+title: Federation User Guide
 ---
 
 This guide explains how we can manage multiple kubernetes clusters using

docs/user-guide/federation/namespaces.md

@@ -1,4 +1,5 @@
 ---
+title: Federated Namespaces
 ---
 
 This guide explains how to use namespaces in Federation control plane.

docs/user-guide/federation/replicasets.md

@@ -1,4 +1,5 @@
 ---
+title: Federated ReplicaSets
 ---
 
 This guide explains how to use replica sets in the Federation control plane.

docs/user-guide/federation/secrets.md

@@ -1,4 +1,5 @@
 ---
+title: Federated Secrets
 ---
 
 This guide explains how to use secrets in Federation control plane.

docs/user-guide/garbage-collection.md

@@ -1,7 +1,7 @@
 ---
 assignees:
 - caesarxuchao
-
+title: Garbage Collection (Beta)
 ---
 
 * TOC

docs/user-guide/getting-into-containers.md

@@ -2,7 +2,7 @@
 assignees:
 - caesarxuchao
 - mikedanese
-
+title: Running Commands in a Container with kubectl exec
 ---
 
 Developers can use `kubectl exec` to run commands in a container. This guide demonstrates two use cases.

docs/user-guide/horizontal-pod-autoscaling/index.md

@@ -2,7 +2,7 @@
 assignees:
 - fgrzadkowski
 - jszczepkowski
-
+title: Horizontal Pod Autoscaling
 ---
 
 This document describes the current state of Horizontal Pod Autoscaling in Kubernetes.

docs/user-guide/horizontal-pod-autoscaling/walkthrough.md

@@ -3,7 +3,7 @@ assignees:
 - fgrzadkowski
 - jszczepkowski
 - justinsb
-
+title: Horizontal Pod Autoscaling
 ---
 
 Horizontal Pod Autoscaling automatically scales the number of pods

docs/user-guide/identifiers.md

@@ -2,7 +2,7 @@
 assignees:
 - mikedanese
 - thockin
-
+title: Names
 ---
 
 All objects in the Kubernetes REST API are unambiguously identified by a Name and a UID.

docs/user-guide/images.md

@@ -2,7 +2,7 @@
 assignees:
 - erictune
 - thockin
-
+title: Images
 ---
 
 Each container in a pod has its own image.  Currently, the only type of image supported is a [Docker Image](https://docs.docker.com/engine/tutorials/dockerimages/).

docs/user-guide/index.md

@@ -1,7 +1,7 @@
 ---
 assignees:
 - davidopp
-
+title: Guides
 ---
 
 The Kubernetes **Guides** can help you work with various aspects of the Kubernetes system.

docs/user-guide/ingress.md

@@ -1,7 +1,7 @@
 ---
 assignees:
 - bprashanth
-
+title: Ingress Resources
 ---
 
 * TOC

docs/user-guide/introspection-and-debugging.md

@@ -2,7 +2,7 @@
 assignees:
 - janetkuo
 - thockin
-
+title: Application Introspection and Debugging
 ---
 
 Once your application is running, you'll inevitably need to debug problems with it.

docs/user-guide/jobs.md

@@ -2,7 +2,7 @@
 assignees:
 - erictune
 - soltysh
-
+title: Jobs
 ---
 
 * TOC

docs/user-guide/jobs/expansions/index.md

@@ -1,4 +1,5 @@
 ---
+title: Parallel Processing using Expansions
 ---
 
 * TOC

docs/user-guide/jobs/work-queue-1/index.md

@@ -1,4 +1,5 @@
 ---
+title: Coarse Parallel Processing using a Work Queue
 ---
 
 * TOC

docs/user-guide/jobs/work-queue-2/index.md

@@ -1,4 +1,5 @@
 ---
+title: Fine Parallel Processing using a Work Queue
 ---
 
 * TOC

docs/user-guide/jsonpath.md

@@ -1,5 +1,5 @@
 ---
-
+title: JSONpath Support
 ---
 
 JSONPath template is composed of JSONPath expressions enclosed by {}.

docs/user-guide/kubeconfig-file.md

@@ -1,10 +1,10 @@
----
-assignees:
-- mikedanese
-- thockin
-
----
-
+---
+assignees:
+- mikedanese
+- thockin
+title: Authenticating Across Clusters with kubeconfig
+---
+
 Authentication in kubernetes can differ for different individuals.
 
 - A running kubelet might have one way of authenticating (i.e. certificates).

docs/user-guide/kubectl-cheatsheet.md

@@ -4,7 +4,7 @@ assignees:
 - erictune
 - krousey
 - clove
-
+title: kubectl Cheat Sheet
 ---
 
 See also: [Kubectl Overview](/docs/user-guide/kubectl-overview/) and [JsonPath Guide](/docs/user-guide/jsonpath).

docs/user-guide/kubectl-conventions.md

@@ -2,7 +2,7 @@
 assignees:
 - bgrant0607
 - janetkuo
-
+title: kubectl Usage Conventions
 ---
 
 * TOC

docs/user-guide/kubectl-overview.md

@@ -2,7 +2,7 @@
 assignees:
 - bgrant0607
 - hw-qiaolei
-
+title: kubectl Overview
 ---
 
 `kubectl` is a command line interface for running commands against Kubernetes clusters. This overview covers `kubectl` syntax, describes the command operations, and provides common examples. For details about each command, including all the supported flags and subcommands, see the [kubectl](/docs/user-guide/kubectl) reference documentation. For installation instructions see [prerequisites](/docs/user-guide/prereqs).

docs/user-guide/kubectl/index.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl
 ---
+
 ## kubectl
 
 kubectl controls the Kubernetes cluster manager

docs/user-guide/kubectl/kubectl_annotate.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl annotate
 ---
+
 ## kubectl annotate
 
 Update the annotations on a resource

docs/user-guide/kubectl/kubectl_api-versions.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl api-versions
 ---
+
 ## kubectl api-versions
 
 Print the supported API versions on the server, in the form of "group/version"

docs/user-guide/kubectl/kubectl_apply.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl apply
 ---
+
 ## kubectl apply
 
 Apply a configuration to a resource by filename or stdin

docs/user-guide/kubectl/kubectl_attach.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl attach
 ---
+
 ## kubectl attach
 
 Attach to a running container

docs/user-guide/kubectl/kubectl_autoscale.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl autoscale
 ---
+
 ## kubectl autoscale
 
 Auto-scale a Deployment, ReplicaSet, or ReplicationController

docs/user-guide/kubectl/kubectl_cluster-info.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl cluster-info
 ---
+
 ## kubectl cluster-info
 
 Display cluster info

docs/user-guide/kubectl/kubectl_config.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl config
 ---
+
 ## kubectl config
 
 Modify kubeconfig files

docs/user-guide/kubectl/kubectl_config_current-context.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl config current-context
 ---
+
 ## kubectl config current-context
 
 Displays the current-context

docs/user-guide/kubectl/kubectl_config_set-cluster.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl config set-cluster
 ---
+
 ## kubectl config set-cluster
 
 Sets a cluster entry in kubeconfig

docs/user-guide/kubectl/kubectl_config_set-context.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl config set-context
 ---
+
 ## kubectl config set-context
 
 Sets a context entry in kubeconfig

docs/user-guide/kubectl/kubectl_config_set-credentials.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl config set-credentials
 ---
+
 ## kubectl config set-credentials
 
 Sets a user entry in kubeconfig

docs/user-guide/kubectl/kubectl_config_set.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl config set
 ---
+
 ## kubectl config set
 
 Sets an individual value in a kubeconfig file

docs/user-guide/kubectl/kubectl_config_unset.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl config unset
 ---
+
 ## kubectl config unset
 
 Unsets an individual value in a kubeconfig file

docs/user-guide/kubectl/kubectl_config_use-context.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl config use-context
 ---
+
 ## kubectl config use-context
 
 Sets the current-context in a kubeconfig file

docs/user-guide/kubectl/kubectl_config_view.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl config view
 ---
+
 ## kubectl config view
 
 Display merged kubeconfig settings or a specified kubeconfig file

docs/user-guide/kubectl/kubectl_convert.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl convert
 ---
+
 ## kubectl convert
 
 Convert config files between different API versions

docs/user-guide/kubectl/kubectl_cordon.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl cordon
 ---
+
 ## kubectl cordon
 
 Mark node as unschedulable

docs/user-guide/kubectl/kubectl_create.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl create
 ---
+
 ## kubectl create
 
 Create a resource by filename or stdin

docs/user-guide/kubectl/kubectl_create_configmap.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl create configmap
 ---
+
 ## kubectl create configmap
 
 Create a configmap from a local file, directory or literal value

docs/user-guide/kubectl/kubectl_create_namespace.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl create namespace
 ---
+
 ## kubectl create namespace
 
 Create a namespace with the specified name

docs/user-guide/kubectl/kubectl_create_secret.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl create secret
 ---
+
 ## kubectl create secret
 
 Create a secret using specified subcommand

docs/user-guide/kubectl/kubectl_create_secret_docker-registry.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl create secret docker-registry
 ---
+
 ## kubectl create secret docker-registry
 
 Create a secret for use with a Docker registry

docs/user-guide/kubectl/kubectl_create_secret_generic.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl create secret generic
 ---
+
 ## kubectl create secret generic
 
 Create a secret from a local file, directory or literal value

docs/user-guide/kubectl/kubectl_create_serviceaccount.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl create serviceaccount
 ---
+
 ## kubectl create serviceaccount
 
 Create a service account with the specified name

docs/user-guide/kubectl/kubectl_delete.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl delete
 ---
+
 ## kubectl delete
 
 Delete resources by filenames, stdin, resources and names, or by resources and label selector

docs/user-guide/kubectl/kubectl_describe.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl describe
 ---
+
 ## kubectl describe
 
 Show details of a specific resource or group of resources

docs/user-guide/kubectl/kubectl_drain.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl drain
 ---
+
 ## kubectl drain
 
 Drain node in preparation for maintenance

docs/user-guide/kubectl/kubectl_edit.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl edit
 ---
+
 ## kubectl edit
 
 Edit a resource on the server

docs/user-guide/kubectl/kubectl_exec.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl exec
 ---
+
 ## kubectl exec
 
 Execute a command in a container

docs/user-guide/kubectl/kubectl_explain.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl explain
 ---
+
 ## kubectl explain
 
 Documentation of resources

docs/user-guide/kubectl/kubectl_expose.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl expose
 ---
+
 ## kubectl expose
 
 Take a replication controller, service, deployment or pod and expose it as a new Kubernetes Service

docs/user-guide/kubectl/kubectl_get.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl get
 ---
+
 ## kubectl get
 
 Display one or many resources

docs/user-guide/kubectl/kubectl_label.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl label
 ---
+
 ## kubectl label
 
 Update the labels on a resource

docs/user-guide/kubectl/kubectl_logs.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl logs
 ---
+
 ## kubectl logs
 
 Print the logs for a container in a pod

docs/user-guide/kubectl/kubectl_patch.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl patch
 ---
+
 ## kubectl patch
 
 Update field(s) of a resource using strategic merge patch

docs/user-guide/kubectl/kubectl_port-forward.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl port-forward
 ---
+
 ## kubectl port-forward
 
 Forward one or more local ports to a pod

docs/user-guide/kubectl/kubectl_proxy.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl proxy
 ---
+
 ## kubectl proxy
 
 Run a proxy to the Kubernetes API server

docs/user-guide/kubectl/kubectl_replace.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl replace
 ---
+
 ## kubectl replace
 
 Replace a resource by filename or stdin

docs/user-guide/kubectl/kubectl_rolling-update.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl rolling-update
 ---
+
 ## kubectl rolling-update
 
 Perform a rolling update of the given ReplicationController

docs/user-guide/kubectl/kubectl_rollout.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl rollout
 ---
+
 ## kubectl rollout
 
 Manage a deployment rollout

docs/user-guide/kubectl/kubectl_rollout_history.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl rollout history
 ---
+
 ## kubectl rollout history
 
 View rollout history

docs/user-guide/kubectl/kubectl_rollout_pause.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl rollout pause
 ---
+
 ## kubectl rollout pause
 
 Mark the provided resource as paused

docs/user-guide/kubectl/kubectl_rollout_resume.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl rollout resume
 ---
+
 ## kubectl rollout resume
 
 Resume a paused resource

docs/user-guide/kubectl/kubectl_rollout_undo.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl rollout undo
 ---
+
 ## kubectl rollout undo
 
 Undo a previous rollout

docs/user-guide/kubectl/kubectl_run.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl run
 ---
+
 ## kubectl run
 
 Run a particular image on the cluster

docs/user-guide/kubectl/kubectl_scale.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl scale
 ---
+
 ## kubectl scale
 
 Set a new size for a Deployment, ReplicaSet, Replication Controller, or Job

docs/user-guide/kubectl/kubectl_stop.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl stop
 ---
+
 ## kubectl stop
 
 Deprecated: Gracefully shut down a resource by name or filename.

docs/user-guide/kubectl/kubectl_uncordon.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl uncordon
 ---
+
 ## kubectl uncordon
 
 Mark node as schedulable

docs/user-guide/kubectl/kubectl_version.md

@@ -1,5 +1,7 @@
 ---
+title: kubectl version
 ---
+
 ## kubectl version
 
 Print the client and server version information

docs/user-guide/labels.md

@@ -1,7 +1,7 @@
 ---
 assignees:
 - mikedanese
-
+title: Labels and Selectors
 ---
 
 _Labels_ are key/value pairs that are attached to objects, such as pods.