Add spacing after the description

Author: russgold

docs/domains/Domain.md

@@ -1,6 +1,7 @@
 ### Domain
 
 Domain represents a WebLogic domain and how it will be realized in the Kubernetes cluster.
+
 | Name | Type | Description |
 | --- | --- | --- |
 | apiVersion | string | The API version for the Domain. Must be 'weblogic.oracle/v2'. |
@@ -12,6 +13,7 @@ Domain represents a WebLogic domain and how it will be realized in the Kubernete
 ### Domain Spec
 
 DomainSpec is a description of a domain.
+
 | Name | Type | Description |
 | --- | --- | --- |
 | adminServer | [Admin Server](#admin-server) | Configuration for the admin server. |
@@ -39,6 +41,7 @@ DomainSpec is a description of a domain.
 ### Domain Status
 
 DomainStatus represents information about the status of a domain. Status may trail the actual state of a system.
+
 | Name | Type | Description |
 | --- | --- | --- |
 | conditions | array of [Domain Condition](#domain-condition) | Current service state of domain. |
@@ -51,6 +54,7 @@ DomainStatus represents information about the status of a domain. Status may tra
 ### Admin Server
 
 AdminServer represents the operator configuration for the admin server.
+
 | Name | Type | Description |
 | --- | --- | --- |
 | adminService | [Admin Service](#admin-service) | Configures which of the admin server's WebLogic admin channels should be exposed outside the Kubernetes cluster via a node port service. |
@@ -63,6 +67,7 @@ AdminServer represents the operator configuration for the admin server.
 ### Cluster
 
 An element representing a cluster in the domain configuration.
+
 | Name | Type | Description |
 | --- | --- | --- |
 | clusterName | string | The name of this cluster. Required |
@@ -78,6 +83,7 @@ An element representing a cluster in the domain configuration.
 ### Managed Server
 
 ManagedServer represents the operator configuration for a single managed server.
+
 | Name | Type | Description |
 | --- | --- | --- |
 | restartVersion | string | If present, every time this value is updated the operator will restart the required servers. |
@@ -90,6 +96,7 @@ ManagedServer represents the operator configuration for a single managed server.
 ### Server Pod
 
 ServerPod describes the configuration for a Kubernetes pod for a server.
+
 | Name | Type | Description |
 | --- | --- | --- |
 | annotations |  | The annotations to be attached to generated resources. |
@@ -167,6 +174,7 @@ ServerPod describes the configuration for a Kubernetes pod for a server.
 ### Channel
 
 Describes a single channel used by the admin server.
+
 | Name | Type | Description |
 | --- | --- | --- |
 | channelName | string | Name of channel.<br/>'default' refers to the admin server's default channel (configured via the ServerMBean's ListenPort) <br/>'default-secure' refers to the admin server's default secure channel (configured via the ServerMBean's SSLMBean's ListenPort) <br/>'default-admin' refers to the admin server's default administrative channel (configured via the DomainMBean's AdministrationPort) <br/>Otherwise, the name is the name of one of the admin server's network access points (configured via the ServerMBean's NetworkAccessMBeans). |

docs/domains/k8s1.9.0.md

@@ -6,6 +6,7 @@
 ### Object Meta
 
 ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.
+
 | Name | Type | Description |
 | --- | --- | --- |
 | annotations |  | Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: http://kubernetes.io/docs/user-guide/annotations |
@@ -28,13 +29,15 @@ ObjectMeta is metadata that all persisted resources must have, which includes al
 ### Local Object Reference
 
 LocalObjectReference contains enough information to let you locate the referenced object inside the same namespace.
+
 | Name | Type | Description |
 | --- | --- | --- |
 | name | string | Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
 
 ### Secret Reference
 
 SecretReference represents a Secret Reference. It has enough information to retrieve secret in any namespace
+
 | Name | Type | Description |
 | --- | --- | --- |
 | name | string | Name is unique within a namespace to reference a secret resource. |
@@ -43,6 +46,7 @@ SecretReference represents a Secret Reference. It has enough information to retr
 ### Security Context
 
 SecurityContext holds security configuration that will be applied to a container. Some fields are present in both SecurityContext and PodSecurityContext.  When both are set, the values in SecurityContext take precedence.
+
 | Name | Type | Description |
 | --- | --- | --- |
 | allowPrivilegeEscalation | boolean | AllowPrivilegeEscalation controls whether a process can gain more privileges than its parent process. This bool directly controls if the no_new_privs flag will be set on the container process. AllowPrivilegeEscalation is true always when the container is: 1) run as Privileged 2) has CAP_SYS_ADMIN |
@@ -56,6 +60,7 @@ SecurityContext holds security configuration that will be applied to a container
 ### Env Var
 
 EnvVar represents an environment variable present in a Container.
+
 | Name | Type | Description |
 | --- | --- | --- |
 | name | string | Name of the environment variable. Must be a C_IDENTIFIER. |
@@ -65,6 +70,7 @@ EnvVar represents an environment variable present in a Container.
 ### Pod Security Context
 
 PodSecurityContext holds pod-level security attributes and common container settings. Some fields are also present in container.securityContext.  Field values of container.securityContext take precedence over field values of PodSecurityContext.
+
 | Name | Type | Description |
 | --- | --- | --- |
 | fsGroup |  | A special supplemental group that applies to all containers in a pod. Some volume types allow the Kubelet to change the ownership of that volume to be owned by the pod:<br/><br/>1. The owning GID will be the FSGroup 2. The setgid bit is set (new files created in the volume will be owned by FSGroup) 3. The permission bits are OR'd with rw-rw----<br/><br/>If unset, the Kubelet will not modify the ownership and permissions of any volume. |
@@ -76,6 +82,7 @@ PodSecurityContext holds pod-level security attributes and common container sett
 ### Resource Requirements
 
 ResourceRequirements describes the compute resource requirements.
+
 | Name | Type | Description |
 | --- | --- | --- |
 | limits |  | Limits describes the maximum amount of compute resources allowed. More info: https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/ |
@@ -84,6 +91,7 @@ ResourceRequirements describes the compute resource requirements.
 ### Volume Mount
 
 VolumeMount describes a mounting of a Volume within a container.
+
 | Name | Type | Description |
 | --- | --- | --- |
 | mountPath | string | Path within the container at which the volume should be mounted.  Must not contain ':'. |
@@ -95,6 +103,7 @@ VolumeMount describes a mounting of a Volume within a container.
 ### Volume
 
 Volume represents a named volume in a pod that may be accessed by any container in the pod.
+
 | Name | Type | Description |
 | --- | --- | --- |
 | awsElasticBlockStore | [AWS Elastic Block Store Volume Source](#aws-elastic-block-store-volume-source) | AWSElasticBlockStore represents an AWS Disk resource that is attached to a kubelet's host machine and then exposed to the pod. More info: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore |

json-schema/src/main/java/oracle/kubernetes/json/YamlDocGenerator.java

@@ -37,7 +37,7 @@ public String generate(String reference, Map<String, Object> schema) {
     referencesNeeded.remove(reference);
     StringBuilder sb = new StringBuilder("### ");
     sb.append(toStructureName(reference)).append("\n\n");
-    Optional.ofNullable(getDescription(schema)).ifPresent(s -> sb.append(s).append("\n"));
+    Optional.ofNullable(getDescription(schema)).ifPresent(s -> sb.append(s).append("\n\n"));
     sb.append(generateForClass(schema));
     while (!referencesNeeded.isEmpty()) {
       generateForDefinition(sb, referencesNeeded.get(0));

json-schema/src/test/java/oracle/kubernetes/json/YamlDocGeneratorTest.java

@@ -180,6 +180,7 @@ public void generateMarkdownWithReferencedSections() {
                 "### Derived Object",
                 "",
                 "A simple object used for testing",
+                "",
                 tableHeader(),
                 tableEntry("aBoolean", "boolean", "A flag"),
                 tableEntry("anInt", "number", "An int<br/>value"))));
@@ -249,6 +250,7 @@ public void whenExternalSchemaSpecified_generateMarkdownForIt() throws IOExcepti
                 "### Env Var",
                 "",
                 "EnvVar represents an environment variable present in a Container.",
+                "",
                 tableHeader(),
                 tableEntry(
                     "name",