Merge pull request #11551 from a-robinson/docs

Improve syntax highlighting for design and devel docs

docs/design/persistent-storage.md

@@ -127,7 +127,7 @@ Events that communicate the state of a mounted volume are left to the volume plu
 
 An administrator provisions storage by posting PVs to the API.  Various way to automate this task can be scripted.  Dynamic provisioning is a future feature that can maintain levels of PVs.
 
-```
+```yaml
 POST:
 
 kind: PersistentVolume
@@ -140,15 +140,13 @@ spec:
   persistentDisk:
     pdName: "abc123"
     fsType: "ext4"
+```
 
---------------------------------------------------
-
-kubectl get pv
+```console
+$ kubectl get pv
 
 NAME                LABELS              CAPACITY            ACCESSMODES         STATUS              CLAIM              REASON
 pv0001              map[]               10737418240         RWO                 Pending    
-
-
 ```
 
 #### Users request storage
@@ -157,9 +155,9 @@ A user requests storage by posting a PVC to the API.  Their request contains the
 
 The user must be within a namespace to create PVCs.
 
-```
-
+```yaml
 POST: 
+
 kind: PersistentVolumeClaim
 apiVersion: v1
 metadata:
@@ -170,15 +168,13 @@ spec:
   resources:
     requests:
       storage: 3
+```
 
---------------------------------------------------
-
-kubectl get pvc
-
+```console
+$ kubectl get pvc
 
 NAME                LABELS              STATUS              VOLUME
 myclaim-1           map[]               pending                         
-
 ```
 
 
@@ -186,9 +182,8 @@ myclaim-1           map[]               pending
 
   The ```PersistentVolumeClaimBinder``` attempts to find an available volume that most closely matches the user's request.  If one exists, they are bound by putting a reference on the PV to the PVC.  Requests can go unfulfilled if a suitable match is not found.
 
-```
-
-kubectl get pv
+```console
+$ kubectl get pv
 
 NAME                LABELS              CAPACITY            ACCESSMODES         STATUS              CLAIM                                                        REASON
 pv0001              map[]               10737418240         RWO                 Bound               myclaim-1 / f4b3d283-c0ef-11e4-8be4-80e6500a981e
@@ -198,8 +193,6 @@ kubectl get pvc
 
 NAME                LABELS              STATUS              VOLUME
 myclaim-1           map[]               Bound               b16e91d6-c0ef-11e4-8be4-80e6500a981e
-
-
 ```
 
 #### Claim usage
@@ -208,7 +201,7 @@ The claim holder can use their claim as a volume.  The ```PersistentVolumeClaimV
 
 The claim holder owns the claim and its data for as long as the claim exists.  The pod using the claim can be deleted, but the claim remains in the user's namespace.  It can be used again and again by many pods.
 
-```
+```yaml
 POST: 
 
 kind: Pod
@@ -229,17 +222,14 @@ spec:
          accessMode: ReadWriteOnce
          claimRef:
            name: myclaim-1
-
 ```
 
 #### Releasing a claim and Recycling a volume
 
 When a claim holder is finished with their data, they can delete their claim.
 
-```
-
-kubectl delete pvc myclaim-1
-
+```console
+$ kubectl delete pvc myclaim-1
 ```
 
 The ```PersistentVolumeClaimBinder``` will reconcile this by removing the claim reference from the PV and change the PVs status to 'Released'.