From 393a2896d8d172556f20471f01625cd67784d3ba Mon Sep 17 00:00:00 2001
From: David Gageot <david@gageot.net>
Date: Fri, 1 Mar 2019 07:26:58 +0100
Subject: [PATCH 1/7] Check for empty descriptions on the latest schema

Also ignore non marshalled fields

Signed-off-by: David Gageot <david@gageot.net>
---
 docs/content/en/schemas/v1beta6.json | 46 +++++++++++++---------------
 hack/schemas/main.go                 | 34 ++++++++++++++------
 pkg/skaffold/schema/latest/config.go | 16 ++++++++--
 3 files changed, 59 insertions(+), 37 deletions(-)

diff --git a/docs/content/en/schemas/v1beta6.json b/docs/content/en/schemas/v1beta6.json
index 22e7b65b4e4..71d6f0562f0 100755
--- a/docs/content/en/schemas/v1beta6.json
+++ b/docs/content/en/schemas/v1beta6.json
@@ -50,9 +50,6 @@
       "anyOf": [
         {
           "properties": {
-            "-": {
-              "type": "string"
-            },
             "context": {
               "type": "string",
               "description": "directory where the artifact's sources are to be found.",
@@ -89,16 +86,12 @@
             "image",
             "context",
             "sync",
-            "-",
             "plugin"
           ],
           "additionalProperties": false
         },
         {
           "properties": {
-            "-": {
-              "type": "string"
-            },
             "context": {
               "type": "string",
               "description": "directory where the artifact's sources are to be found.",
@@ -140,7 +133,6 @@
             "image",
             "context",
             "sync",
-            "-",
             "plugin",
             "docker"
           ],
@@ -148,9 +140,6 @@
         },
         {
           "properties": {
-            "-": {
-              "type": "string"
-            },
             "bazel": {
               "$ref": "#/definitions/BazelArtifact",
               "description": "(beta) requires bazel CLI to be installed and the sources to contain [Bazel](https://bazel.build/) configuration files.",
@@ -192,7 +181,6 @@
             "image",
             "context",
             "sync",
-            "-",
             "plugin",
             "bazel"
           ],
@@ -200,9 +188,6 @@
         },
         {
           "properties": {
-            "-": {
-              "type": "string"
-            },
             "context": {
               "type": "string",
               "description": "directory where the artifact's sources are to be found.",
@@ -244,7 +229,6 @@
             "image",
             "context",
             "sync",
-            "-",
             "plugin",
             "jibMaven"
           ],
@@ -252,9 +236,6 @@
         },
         {
           "properties": {
-            "-": {
-              "type": "string"
-            },
             "context": {
               "type": "string",
               "description": "directory where the artifact's sources are to be found.",
@@ -296,7 +277,6 @@
             "image",
             "context",
             "sync",
-            "-",
             "plugin",
             "jibGradle"
           ],
@@ -335,7 +315,9 @@
         "jibMaven",
         "jibGradle"
       ],
-      "additionalProperties": false
+      "additionalProperties": false,
+      "description": "describes how to build an artifact.",
+      "x-intellij-html-description": "describes how to build an artifact.\n"
     },
     "BazelArtifact": {
       "required": [
@@ -745,7 +727,9 @@
       "x-intellij-html-description": "(beta) tags images with a configurable template string.\n"
     },
     "ExecEnvironment": {
-      "type": "string"
+      "type": "string",
+      "description": "name of an execution environment.",
+      "x-intellij-html-description": "name of an execution environment.\n"
     },
     "ExecutionEnvironment": {
       "properties": {
@@ -866,6 +850,8 @@
             "type": "string"
           },
           "type": "array",
+          "description": "additional flags passed on every command.",
+          "x-intellij-html-description": "additional flags passed on every command.\n",
           "default": "[]"
         },
         "install": {
@@ -873,6 +859,8 @@
             "type": "string"
           },
           "type": "array",
+          "description": "additional flags passed to (`helm install`).",
+          "x-intellij-html-description": "additional flags passed to (<code>helm install</code>).\n",
           "default": "[]"
         },
         "upgrade": {
@@ -880,6 +868,8 @@
             "type": "string"
           },
           "type": "array",
+          "description": "additional flags passed to (`helm upgrade`).",
+          "x-intellij-html-description": "additional flags passed to (<code>helm upgrade</code>).\n",
           "default": "[]"
         }
       },
@@ -924,7 +914,9 @@
         "fqn",
         "helm"
       ],
-      "additionalProperties": false
+      "additionalProperties": false,
+      "description": "describes an image configuration.",
+      "x-intellij-html-description": "describes an image configuration.\n"
     },
     "HelmImageStrategy": {
       "anyOf": [
@@ -1096,7 +1088,9 @@
         "packaged",
         "imageStrategy"
       ],
-      "additionalProperties": false
+      "additionalProperties": false,
+      "description": "describes a helm release to be deployed.",
+      "x-intellij-html-description": "describes a helm release to be deployed.\n"
     },
     "JSONPatch": {
       "required": [
@@ -1545,7 +1539,9 @@
         "deploy",
         "profiles"
       ],
-      "additionalProperties": false
+      "additionalProperties": false,
+      "description": "describes a Skaffold pipeline.",
+      "x-intellij-html-description": "describes a Skaffold pipeline.\n"
     },
     "TagPolicy": {
       "properties": {
diff --git a/hack/schemas/main.go b/hack/schemas/main.go
index 6a7cf5131b2..ae56025d15b 100644
--- a/hack/schemas/main.go
+++ b/hack/schemas/main.go
@@ -39,6 +39,10 @@ const (
 	defPrefix = "#/definitions/"
 )
 
+type schemaGenerator struct {
+	strict bool
+}
+
 type Schema struct {
 	*Definition
 	Version     string                 `json:"$schema,omitempty"`
@@ -71,20 +75,27 @@ func generateSchemas(root string, dryRun bool) (bool, error) {
 
 	for i, version := range schema.SchemaVersions {
 		apiVersion := strings.TrimPrefix(version.APIVersion, "skaffold/")
+
 		folder := apiVersion
+		strict := false
 		if i == len(schema.SchemaVersions)-1 {
 			folder = "latest"
+			strict = true
 		}
 
 		input := fmt.Sprintf("%s/pkg/skaffold/schema/%s/config.go", root, folder)
-		buf, err := generateSchema(input)
+		output := fmt.Sprintf("%s/docs/content/en/schemas/%s.json", root, apiVersion)
+
+		generator := schemaGenerator{
+			strict: strict,
+		}
+
+		buf, err := generator.Apply(input)
 		if err != nil {
 			return false, errors.Wrapf(err, "unable to generate schema for version %s", version.APIVersion)
 		}
 
-		output := fmt.Sprintf("%s/docs/content/en/schemas/%s.json", root, apiVersion)
 		var current []byte
-
 		if _, err := os.Stat(output); err == nil {
 			var err error
 			current, err = ioutil.ReadFile(output)
@@ -128,7 +139,7 @@ func setTypeOrRef(def *Definition, typeName string) {
 	}
 }
 
-func newDefinition(name string, t ast.Expr, comment string) *Definition {
+func (g *schemaGenerator) newDefinition(name string, t ast.Expr, comment string) *Definition {
 	def := &Definition{}
 
 	switch tt := t.(type) {
@@ -155,7 +166,7 @@ func newDefinition(name string, t ast.Expr, comment string) *Definition {
 
 	case *ast.ArrayType:
 		def.Type = "array"
-		def.Items = newDefinition("", tt.Elt, "")
+		def.Items = g.newDefinition("", tt.Elt, "")
 		if def.Items.Ref == "" {
 			def.Default = "[]"
 		}
@@ -163,7 +174,7 @@ func newDefinition(name string, t ast.Expr, comment string) *Definition {
 	case *ast.MapType:
 		def.Type = "object"
 		def.Default = "{}"
-		def.AdditionalProperties = newDefinition("", tt.Value, "")
+		def.AdditionalProperties = g.newDefinition("", tt.Value, "")
 
 	case *ast.StructType:
 		for _, field := range tt.Fields.List {
@@ -176,7 +187,7 @@ func newDefinition(name string, t ast.Expr, comment string) *Definition {
 				continue
 			}
 
-			if yamlName == "" {
+			if yamlName == "" || yamlName == "-" {
 				continue
 			}
 
@@ -189,7 +200,7 @@ func newDefinition(name string, t ast.Expr, comment string) *Definition {
 			}
 
 			def.PreferredOrder = append(def.PreferredOrder, yamlName)
-			def.Properties[yamlName] = newDefinition(field.Names[0].Name, field.Type, field.Doc.Text())
+			def.Properties[yamlName] = g.newDefinition(field.Names[0].Name, field.Type, field.Doc.Text())
 			def.AdditionalProperties = false
 		}
 	}
@@ -217,6 +228,9 @@ func newDefinition(name string, t ast.Expr, comment string) *Definition {
 	description = strings.TrimPrefix(description, name+" ")
 
 	def.Description = description
+	if g.strict && name != "" && description == "" {
+		panic(fmt.Sprintf("no description on field %s", name))
+	}
 
 	// Convert to HTML
 	html := string(blackfriday.Run([]byte(description), blackfriday.WithNoExtensions()))
@@ -227,7 +241,7 @@ func newDefinition(name string, t ast.Expr, comment string) *Definition {
 	return def
 }
 
-func generateSchema(inputPath string) ([]byte, error) {
+func (g *schemaGenerator) Apply(inputPath string) ([]byte, error) {
 	fset := token.NewFileSet()
 	node, err := parser.ParseFile(fset, inputPath, nil, parser.ParseComments)
 	if err != nil {
@@ -251,7 +265,7 @@ func generateSchema(inputPath string) ([]byte, error) {
 
 			name := typeSpec.Name.Name
 			preferredOrder = append(preferredOrder, name)
-			definitions[name] = newDefinition(name, typeSpec.Type, declaration.Doc.Text())
+			definitions[name] = g.newDefinition(name, typeSpec.Type, declaration.Doc.Text())
 		}
 	}
 
diff --git a/pkg/skaffold/schema/latest/config.go b/pkg/skaffold/schema/latest/config.go
index 19dc03d84b0..b924af40309 100644
--- a/pkg/skaffold/schema/latest/config.go
+++ b/pkg/skaffold/schema/latest/config.go
@@ -28,6 +28,7 @@ func NewSkaffoldPipeline() util.VersionedConfig {
 	return new(SkaffoldPipeline)
 }
 
+// SkaffoldPipeline describes a Skaffold pipeline.
 type SkaffoldPipeline struct {
 	// APIVersion is the version of the configuration.
 	APIVersion string `yaml:"apiVersion"`
@@ -69,6 +70,7 @@ type BuildConfig struct {
 	BuildType `yaml:",inline"`
 }
 
+// ExecEnvironment is the name of an execution environment.
 type ExecEnvironment string
 
 // ExecutionEnvironment is the environment in which the build should run (ex. local or in-cluster, etc.).
@@ -351,8 +353,13 @@ type HelmDeploy struct {
 // line to helm either on every command (Global), on install (Install)
 // or on update (Update).
 type HelmDeployFlags struct {
-	Global  []string `yaml:"global,omitempty"`
+	// Global are additional flags passed on every command.
+	Global []string `yaml:"global,omitempty"`
+
+	// Install are additional flags passed to (`helm install`).
 	Install []string `yaml:"install,omitempty"`
+
+	// Upgrade are additional flags passed to (`helm upgrade`).
 	Upgrade []string `yaml:"upgrade,omitempty"`
 }
 
@@ -366,6 +373,7 @@ type KustomizeDeploy struct {
 	Flags KubectlFlags `yaml:"flags,omitempty"`
 }
 
+// HelmRelease describes a helm release to be deployed.
 type HelmRelease struct {
 	// Name is the name of the Helm release.
 	Name string `yaml:"name,omitempty" yamltags:"required"`
@@ -432,6 +440,7 @@ type HelmImageStrategy struct {
 	HelmImageConfig `yaml:",inline"`
 }
 
+// HelmImageConfig describes an image configuration.
 type HelmImageConfig struct {
 	// HelmFQNConfig is the image configuration uses the syntax `IMAGE-NAME=IMAGE-REPOSITORY:IMAGE-TAG`.
 	HelmFQNConfig *HelmFQNConfig `yaml:"fqn,omitempty"`
@@ -467,7 +476,9 @@ type Artifact struct {
 	// For example: `{"*.py": ".", "css/**/*.css": "app/css"}`.
 	Sync map[string]string `yaml:"sync,omitempty"`
 
-	ArtifactType  `yaml:",inline"`
+	// ArtifactType describes how to build an artifact.
+	ArtifactType `yaml:",inline"`
+
 	WorkspaceHash string `yaml:"-,omitempty"`
 
 	// BuilderPlugin is the plugin used to build this artifact.
@@ -531,6 +542,7 @@ type Activation struct {
 	Command string `yaml:"command,omitempty"`
 }
 
+// ArtifactType describes how to build an artifact.
 type ArtifactType struct {
 	// DockerArtifact (beta) describes an artifact built from a Dockerfile.
 	DockerArtifact *DockerArtifact `yaml:"docker,omitempty" yamltags:"oneOf=artifact"`

From 49963071d780e01e8902542894d6f6bdd44be6d6 Mon Sep 17 00:00:00 2001
From: David Gageot <david@gageot.net>
Date: Fri, 1 Mar 2019 09:46:12 +0100
Subject: [PATCH 2/7] Simplify code

---
 hack/schemas/main.go | 25 +++++++++++++------------
 1 file changed, 13 insertions(+), 12 deletions(-)

diff --git a/hack/schemas/main.go b/hack/schemas/main.go
index ae56025d15b..4db0a9ac514 100644
--- a/hack/schemas/main.go
+++ b/hack/schemas/main.go
@@ -39,6 +39,12 @@ const (
 	defPrefix = "#/definitions/"
 )
 
+var (
+	regexpDefaults = regexp.MustCompile("(.*)Defaults to `(.*)`")
+	regexpExample  = regexp.MustCompile("(.*)For example: `(.*)`")
+	pTags          = regexp.MustCompile("(<p>)|(</p>)")
+)
+
 type schemaGenerator struct {
 	strict bool
 }
@@ -208,35 +214,30 @@ func (g *schemaGenerator) newDefinition(name string, t ast.Expr, comment string)
 	description := strings.TrimSpace(strings.Replace(comment, "\n", " ", -1))
 
 	// Extract default value
-	if m := regexp.MustCompile("(.*)Defaults to `(.*)`").FindStringSubmatch(description); m != nil {
+	if m := regexpDefaults.FindStringSubmatch(description); m != nil {
 		description = strings.TrimSpace(m[1])
 		def.Default = m[2]
 	}
 
 	// Extract example
-	if m := regexp.MustCompile("(.*)For example: `(.*)`").FindStringSubmatch(description); m != nil {
+	if m := regexpExample.FindStringSubmatch(description); m != nil {
 		description = strings.TrimSpace(m[1])
 		def.Examples = []string{m[2]}
 	}
 
 	// Remove type prefix
-	description = strings.TrimPrefix(description, name+" is the ")
-	description = strings.TrimPrefix(description, name+" is ")
-	description = strings.TrimPrefix(description, name+" are the ")
-	description = strings.TrimPrefix(description, name+" are ")
-	description = strings.TrimPrefix(description, name+" lists ")
-	description = strings.TrimPrefix(description, name+" ")
+	if m := regexp.MustCompile("^" + name + " ((is (the )?)|(are (the )?)|(lists ))?(.*)").FindStringSubmatch(description); m != nil {
+		description = m[7]
+	}
 
-	def.Description = description
 	if g.strict && name != "" && description == "" {
 		panic(fmt.Sprintf("no description on field %s", name))
 	}
+	def.Description = description
 
 	// Convert to HTML
 	html := string(blackfriday.Run([]byte(description), blackfriday.WithNoExtensions()))
-	html = strings.Replace(html, "<p>", "", -1)
-	html = strings.Replace(html, "</p>", "", -1)
-	def.HTMLDescription = html
+	def.HTMLDescription = pTags.ReplaceAllString(html, "")
 
 	return def
 }

From df30c04665c5bc531258f70d46a32a5642000a0f Mon Sep 17 00:00:00 2001
From: David Gageot <david@gageot.net>
Date: Fri, 1 Mar 2019 10:20:40 +0100
Subject: [PATCH 3/7] Add some more validation

Signed-off-by: David Gageot <david@gageot.net>
---
 docs/content/en/schemas/v1beta6.json |  8 ++++----
 hack/schemas/main.go                 | 15 +++++++++++++--
 pkg/skaffold/schema/latest/config.go | 10 +++++-----
 3 files changed, 22 insertions(+), 11 deletions(-)

diff --git a/docs/content/en/schemas/v1beta6.json b/docs/content/en/schemas/v1beta6.json
index 71d6f0562f0..bf7df6c18c6 100755
--- a/docs/content/en/schemas/v1beta6.json
+++ b/docs/content/en/schemas/v1beta6.json
@@ -823,8 +823,8 @@
       "properties": {
         "flags": {
           "$ref": "#/definitions/HelmDeployFlags",
-          "description": "Optional flags to send to the helm command",
-          "x-intellij-html-description": "Optional flags to send to the helm command\n"
+          "description": "additional option flags that are passed on the command line to `helm`.",
+          "x-intellij-html-description": "additional option flags that are passed on the command line to <code>helm</code>.\n"
         },
         "releases": {
           "items": {
@@ -879,8 +879,8 @@
         "upgrade"
       ],
       "additionalProperties": false,
-      "description": "describes additional options flags that are passed on the command line to helm either on every command (Global), on install (Install) or on update (Update).",
-      "x-intellij-html-description": "describes additional options flags that are passed on the command line to helm either on every command (Global), on install (Install) or on update (Update).\n"
+      "description": "additional option flags that are passed on the command line to `helm`.",
+      "x-intellij-html-description": "additional option flags that are passed on the command line to <code>helm</code>.\n"
     },
     "HelmFQNConfig": {
       "properties": {
diff --git a/hack/schemas/main.go b/hack/schemas/main.go
index 4db0a9ac514..e146266237b 100644
--- a/hack/schemas/main.go
+++ b/hack/schemas/main.go
@@ -211,6 +211,12 @@ func (g *schemaGenerator) newDefinition(name string, t ast.Expr, comment string)
 		}
 	}
 
+	if g.strict && name != "" {
+		if !strings.HasPrefix(comment, name+" ") {
+			panic(fmt.Sprintf("comment should start with field name on field %s", name))
+		}
+	}
+
 	description := strings.TrimSpace(strings.Replace(comment, "\n", " ", -1))
 
 	// Extract default value
@@ -230,8 +236,13 @@ func (g *schemaGenerator) newDefinition(name string, t ast.Expr, comment string)
 		description = m[7]
 	}
 
-	if g.strict && name != "" && description == "" {
-		panic(fmt.Sprintf("no description on field %s", name))
+	if g.strict && name != "" {
+		if description == "" {
+			panic(fmt.Sprintf("no description on field %s", name))
+		}
+		if !strings.HasSuffix(description, ".") {
+			panic(fmt.Sprintf("description should end with a dot on field %s", name))
+		}
 	}
 	def.Description = description
 
diff --git a/pkg/skaffold/schema/latest/config.go b/pkg/skaffold/schema/latest/config.go
index b924af40309..bfc3277999f 100644
--- a/pkg/skaffold/schema/latest/config.go
+++ b/pkg/skaffold/schema/latest/config.go
@@ -345,13 +345,13 @@ type HelmDeploy struct {
 	// Releases is a list of Helm releases.
 	Releases []HelmRelease `yaml:"releases,omitempty" yamltags:"required"`
 
-	// Optional flags to send to the helm command
+	// Flags are additional option flags that are passed on the command
+	// line to `helm`.
 	Flags HelmDeployFlags `yaml:"flags,omitempty"`
 }
 
-// HelmDeployFlags describes additional options flags that are passed on the command
-// line to helm either on every command (Global), on install (Install)
-// or on update (Update).
+// HelmDeployFlags are additional option flags that are passed on the command
+// line to `helm`.
 type HelmDeployFlags struct {
 	// Global are additional flags passed on every command.
 	Global []string `yaml:"global,omitempty"`
@@ -528,7 +528,7 @@ type JSONPatch struct {
 
 // Activation criteria by which a profile is auto-activated.
 type Activation struct {
-	// Env is a key=value pair. The profile is auto-activated if an Environment
+	// Env is a `key=value` pair. The profile is auto-activated if an Environment
 	// Variable `key` has value `value`.
 	// For example: `ENV=production`.
 	Env string `yaml:"env,omitempty"`

From 3e6ddca2b40499a4bebe67fae1391baeeacc9383 Mon Sep 17 00:00:00 2001
From: David Gageot <david@gageot.net>
Date: Fri, 1 Mar 2019 10:32:22 +0100
Subject: [PATCH 4/7] Cleanup annotated yaml generation code

---
 docs/content/en/docs/references/yaml/main.css |   4 +-
 docs/content/en/docs/references/yaml/main.js  | 268 ++++++++++--------
 2 files changed, 146 insertions(+), 126 deletions(-)

diff --git a/docs/content/en/docs/references/yaml/main.css b/docs/content/en/docs/references/yaml/main.css
index 31052b09a22..90ac4098a8c 100644
--- a/docs/content/en/docs/references/yaml/main.css
+++ b/docs/content/en/docs/references/yaml/main.css
@@ -41,11 +41,11 @@ td:first-child {
     padding: 1px 5px !important;
 }
 
-td.top {
+tr.top td {
     background-color: #EEE;
 }
 
-td.top .comment {
+tr.top .comment {
     color: gray;
 }
 
diff --git a/docs/content/en/docs/references/yaml/main.js b/docs/content/en/docs/references/yaml/main.js
index c7dd610f9c2..b8a599f1446 100644
--- a/docs/content/en/docs/references/yaml/main.js
+++ b/docs/content/en/docs/references/yaml/main.js
@@ -3,173 +3,193 @@ import { unsafeHTML } from "https://unpkg.com/lit-html@1.0.0/directives/unsafe-h
 
 var version;
 (async function() {
-    let l = new URL(import.meta.url);
-    version = l.hash.replace('#skaffold/', '');
-    
-    const response = await fetch(`/schemas/${version}.json`);
-    const json = await response.json();
+  const url = new URL(import.meta.url);
+  version = url.hash.replace("#skaffold/", "");
+
+  const response = await fetch(`/schemas/${version}.json`);
+  const json = await response.json();
+  const table = document.getElementById("table");
 
-    render(html`${template(json.definitions, undefined, '#/definitions/SkaffoldPipeline', 0)}`, document.getElementById("table"));
+  render(html`
+    ${template(json.definitions, undefined, '#/definitions/SkaffoldPipeline', 0)}
+  `, table);
 })();
 
 function* template(definitions, parentDefinition, ref, ident) {
-  const name = ref.replace('#/definitions/', '');
-  
-  let allProperties = [];
-  let seen = {}
-  if (definitions[name].properties) {
-      var properties = definitions[name].properties;
-      for (var key of definitions[name].preferredOrder) {
-          allProperties.push([key, properties[key]]);
-          seen[key] = true;
-      }
+  const name = ref.replace("#/definitions/", "");
+  const allProperties = [];
+  const seen = {};
+
+  const properties = definitions[name].properties;
+  for (const key of (definitions[name].preferredOrder || [])) {
+    allProperties.push([key, properties[key]]);
+    seen[key] = true;
   }
-  if (definitions[name].anyOf) {
-      for (var anyOf of definitions[name].anyOf) {
-          if (anyOf.preferredOrder) {
-              for (var key of anyOf.preferredOrder) {
-                  if (!seen[key]) {
-                      allProperties.push([key, anyOf.properties[key]]);
-                      seen[key] = true;
-                  }
-              }
-          }
-      }
+
+  const anyOfs = definitions[name].anyOf;
+  for (const anyOf of (anyOfs || [])) {
+    for (const key of (anyOf.preferredOrder || [])) {
+      if (seen[key]) continue;
+
+      allProperties.push([key, anyOf.properties[key]]);
+      seen[key] = true;
+    }
   }
 
-  let index = -1
+  let index = -1;
   for (var [key, definition] of allProperties) {
-    var desc = definition['x-intellij-html-description'];
-    let value = definition.default;
     index++;
 
-    if (key === 'apiVersion') {
-        value = `skaffold/${version}`
-    }
-    if (definition.examples) {
-        value = definition.examples[0]
-    }
-    let valueClass = definition.examples ? 'example' : 'value';
-
-    let required = false;
-    if (definitions[name].required) {
-        for (var requiredName of definitions[name].required) {
-            if (requiredName === key) {
-                required = true;
-                break;
-            }
-        }
+    // Key
+    let required = definitions[name].required && definitions[name].required.includes(key);
+    let keyClass = required ? "key required" : "key";
+
+    // Value
+    let value = definition.default;
+    if (key === "apiVersion") {
+      value = `skaffold/${version}`;
+    } else if (definition.examples && definition.examples.length > 0) {
+      value = definition.examples[0];
     }
-    let keyClass = required ? 'key required' : 'key';
+    let valueClass = definition.examples ? "example" : "value";
 
+    // Description
+    const desc = definition["x-intellij-html-description"];
+    
     // Special case for profiles
-    if (name === 'Profile') {
-        if ((key === 'build') || (key === 'test') || (key === 'deploy')) {
-            yield html`
-            <tr>
-                <td><span class="key" style="margin-left: ${ident * 20}px">${key}:</span> <span class="value">{}</span></td>
-                <td><span class="comment">#</span></td>
-                <td><span class="comment">${unsafeHTML(desc)}</span></td>
-            </tr>
-            `;
-            continue
-        }
+    if ((name === "Profile") && (key === "build" || key === "test" || key === "deploy")) {
+      value = "{}";
+      yield html`
+        <tr>
+          <td>
+            <span class="${keyClass}" style="margin-left: ${ident * 20}px">${key}:</span>
+            <span class="${valueClass}">${value}</span>
+          </td>
+          <td><span class="comment">#&nbsp;</span></td>
+          <td><span class="comment">${unsafeHTML(desc)}</span></td>
+        </tr>
+      `;
+      continue;
     }
 
     if (definition.$ref) {
-        // Check if the referenced description is a final one
-        const refName = definition.$ref.replace('#/definitions/', '');
-        if (!definitions[refName].properties && !definitions[refName].anyOf) {
-            value = '{}'
-        }
+      // Check if the referenced description is a final one
+      const refName = definition.$ref.replace("#/definitions/", "");
+      if (!definitions[refName].properties && !definitions[refName].anyOf) {
+        value = "{}";
+      }
 
-        yield html`
-        <tr>
-            <td class="top"><span class="${keyClass}" style="margin-left: ${ident * 20}px">${key}:</span> <span class="${valueClass}">${value}</span></td>
-            <td class="top"><span class="comment">#&nbsp;</span></td>
-            <td class="top"><span class="comment">${unsafeHTML(desc)}</span></td>
+      yield html`
+        <tr class="top">
+          <td>
+            <span class="${keyClass}" style="margin-left: ${ident * 20}px">${key}:</span>
+            <span class="${valueClass}">${value}</span>
+          </td>
+          <td class="comment">#&nbsp;</td>
+          <td class="comment">${unsafeHTML(desc)}</td>
         </tr>
-        `;
+      `;
     } else if (definition.items && definition.items.$ref) {
-        yield html`
-        <tr>
-            <td class="top"><span class="${keyClass}" style="margin-left: ${ident * 20}px">${key}:</span> <span class="${valueClass}">${value}</span></td>
-            <td class="top"><span class="comment">#&nbsp;</span></td>
-            <td class="top"><span class="comment">${unsafeHTML(desc)}</span></td>
+      yield html`
+        <tr class="top">
+          <td>
+            <span class="${keyClass}" style="margin-left: ${ident * 20}px">${key}:</span>
+            <span class="${valueClass}">${value}</span>
+          </td>
+          <td class="comment">#&nbsp;</td>
+          <td class="comment">${unsafeHTML(desc)}</td>
         </tr>
-        `;
-    } else if (parentDefinition && parentDefinition.type === 'array' && (index == 0)) {
-        yield html`
+      `;
+    } else if (parentDefinition && (parentDefinition.type === "array") && (index == 0)) {
+      yield html`
         <tr>
-            <td><span class="${keyClass}" style="margin-left: ${(ident - 1) * 20}px">- ${key}:</span> <span class="${valueClass}">${value}</span></td>
-            <td><span class="comment">#&nbsp;</span></td>
-            <td><span class="comment">${unsafeHTML(desc)}</span></td>
+          <td>
+            <span class="${keyClass}" style="margin-left: ${(ident - 1) * 20}px">- ${key}:</span>
+            <span class="${valueClass}">${value}</span>
+          </td>
+          <td class="comment">#&nbsp;</td>
+          <td class="comment">${unsafeHTML(desc)}</td>
         </tr>
-        `;
-    } else if ((definition.type === 'array') && value && (value != '[]')) {
-        // Parse value to json array
-        let values = JSON.parse(value);
+      `;
+    } else if ((definition.type === "array") && value && (value != "[]")) {
+      // Parse value to json array
+      const values = JSON.parse(value);
 
-        yield html`
+      yield html`
         <tr>
-            <td><span class="${keyClass}" style="margin-left: ${ident * 20}px">${key}:</span></td>
-            <td><span class="comment">#&nbsp;</span></td>
-            <td rowspan="${1 + values.length}"><span class="comment">${unsafeHTML(desc)}</span></td>
+          <td>
+            <span class="${keyClass}" style="margin-left: ${ident * 20}px">${key}:</span>
+          </td>
+          <td class="comment">#&nbsp;</td>
+          <td class="comment" rowspan="${1 + values.length}">
+            ${unsafeHTML(desc)}
+          </td>
         </tr>
-        `;
-
-        for (var v of values) {
-            yield html`
-            <tr>
-                <td><span class="key" style="margin-left: ${ident * 20}px">- <span class="${valueClass}">${v}</span></span></td>
-                <td><span class="comment">#&nbsp;</span></td>
-            </tr>
-            `;
-        }
-    } else if ((definition.type === 'object') && value && (value != '{}')) {
-        // Parse value to json object
-        let values = JSON.parse(value);
+      `;
 
+      for (const v of values) {
         yield html`
+          <tr>
+            <td>
+              <span class="key" style="margin-left: ${ident * 20}px">- <span class="${valueClass}">${v}</span></span>
+            </td>
+            <td class="comment">#&nbsp;</td>
+          </tr>
+        `;
+      }
+    } else if (definition.type === "object" && value && value != "{}") {
+      // Parse value to json object
+      const values = JSON.parse(value);
+
+      yield html`
         <tr>
-            <td><span class="${keyClass}" style="margin-left: ${ident * 20}px">${key}:</span></td>
-            <td><span class="comment">#&nbsp;</span></td>
-            <td rowspan="${1 + Object.keys(values).length}"><span class="comment">${unsafeHTML(desc)}</span></td>
+          <td>
+            <span class="${keyClass}" style="margin-left: ${ident * 20}px">${key}:</span>
+          </td>
+          <td class="comment">#&nbsp;</td>
+          <td class="comment" rowspan="${1 + Object.keys(values).length}">
+            ${unsafeHTML(desc)}
+          </td>
         </tr>
-        `;
+      `;
 
-        for (var k in values) {
-            let v = values[k];
+      for (const k in values) {
+        const v = values[k];
 
-            yield html`
-            <tr>
-                <td><span class="key" style="margin-left: ${(ident+1) * 20}px"><span class="${valueClass}">${k}: ${v}</span></span></td>
-                <td><span class="comment">#&nbsp;</span></td>
-            </tr>
-            `;
-        }
-    } else {
         yield html`
+          <tr>
+            <td>
+              <span class="key" style="margin-left: ${(ident + 1) * 20}px"><span class="${valueClass}">${k}: ${v}</span></span>
+            </td>
+            <td class="comment">#&nbsp;</td>
+          </tr>
+        `;
+      }
+    } else {
+      yield html`
         <tr>
-            <td><span class="${keyClass}" style="margin-left: ${ident * 20}px">${key}:</span> <span class="${valueClass}">${value}</span></td>
-            <td><span class="comment">#&nbsp;</span></td>
-            <td><span class="comment">${unsafeHTML(desc)}</span></td>
+          <td>
+            <span class="${keyClass}" style="margin-left: ${ident * 20}px">${key}:</span>
+            <span class="${valueClass}">${value}</span>
+          </td>
+          <td class="comment">#&nbsp;</td>
+          <td class="comment">${unsafeHTML(desc)}</td>
         </tr>
-        `;
+      `;
     }
 
     // This definition references another definition
     if (definition.$ref) {
-        yield html`
+      yield html`
         ${template(definitions, definition, definition.$ref, ident + 1)}
-        `;
+      `;
     }
 
     // This definition is an array
     if (definition.items && definition.items.$ref) {
-        yield html`
-            ${template(definitions, definition, definition.items.$ref, ident + 1)}
-        `;
+      yield html`
+        ${template(definitions, definition, definition.items.$ref, ident + 1)}
+      `;
     }
   }
 }

From 1482374bdd22d6c212578662505d43b13de2c9d3 Mon Sep 17 00:00:00 2001
From: David Gageot <david@gageot.net>
Date: Fri, 1 Mar 2019 11:03:28 +0100
Subject: [PATCH 5/7] Improve rendering of alpha/beta

Signed-off-by: David Gageot <david@gageot.net>
---
 docs/content/en/docs/references/yaml/main.css |   8 +
 docs/content/en/schemas/v1alpha1.json         |  16 +-
 docs/content/en/schemas/v1alpha2.json         |  44 +-
 docs/content/en/schemas/v1alpha3.json         |  46 +-
 docs/content/en/schemas/v1alpha4.json         |  60 +--
 docs/content/en/schemas/v1alpha5.json         |  62 +--
 docs/content/en/schemas/v1beta1.json          |  62 +--
 docs/content/en/schemas/v1beta2.json          |  62 +--
 docs/content/en/schemas/v1beta3.json          |  64 +--
 docs/content/en/schemas/v1beta4.json          |  66 +--
 docs/content/en/schemas/v1beta5.json          | 466 ++++++++--------
 docs/content/en/schemas/v1beta6.json          | 500 +++++++++---------
 hack/schemas/main.go                          |   6 +-
 pkg/skaffold/schema/latest/config.go          |  68 +--
 pkg/skaffold/schema/v1beta5/config.go         |  64 +--
 15 files changed, 800 insertions(+), 794 deletions(-)

diff --git a/docs/content/en/docs/references/yaml/main.css b/docs/content/en/docs/references/yaml/main.css
index 90ac4098a8c..8864ebc25e3 100644
--- a/docs/content/en/docs/references/yaml/main.css
+++ b/docs/content/en/docs/references/yaml/main.css
@@ -65,3 +65,11 @@ code {
     border-radius: 3px;
     padding: 0 .2em;
 }
+
+em {
+    font-family: unset;
+    font-size: 85%;
+    border: 1px dotted gray;
+    border-radius: 3px;
+    padding: 0 .2em;
+}
diff --git a/docs/content/en/schemas/v1alpha1.json b/docs/content/en/schemas/v1alpha1.json
index 7381ac115c0..fa90d0a12e6 100755
--- a/docs/content/en/schemas/v1alpha1.json
+++ b/docs/content/en/schemas/v1alpha1.json
@@ -34,7 +34,7 @@
       ],
       "additionalProperties": false,
       "description": "represents items that need should be built, along with the context in which they should be built.",
-      "x-intellij-html-description": "represents items that need should be built, along with the context in which they should be built.\n"
+      "x-intellij-html-description": "<p>represents items that need should be built, along with the context in which they should be built.</p>\n"
     },
     "BuildConfig": {
       "anyOf": [
@@ -102,7 +102,7 @@
         }
       ],
       "description": "contains all the configuration for the build steps",
-      "x-intellij-html-description": "contains all the configuration for the build steps\n"
+      "x-intellij-html-description": "<p>contains all the configuration for the build steps</p>\n"
     },
     "BuildType": {
       "properties": {
@@ -119,7 +119,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.",
-      "x-intellij-html-description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.\n"
+      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the build step. Only one field should be populated.</p>\n"
     },
     "DeployConfig": {
       "anyOf": [
@@ -166,7 +166,7 @@
         }
       ],
       "description": "contains all the configuration needed by the deploy steps",
-      "x-intellij-html-description": "contains all the configuration needed by the deploy steps\n"
+      "x-intellij-html-description": "<p>contains all the configuration needed by the deploy steps</p>\n"
     },
     "DeployType": {
       "properties": {
@@ -183,7 +183,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.",
-      "x-intellij-html-description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.\n"
+      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.</p>\n"
     },
     "GoogleCloudBuild": {
       "properties": {
@@ -259,7 +259,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with `kubectl apply`",
-      "x-intellij-html-description": "contains the configuration needed for deploying with <code>kubectl apply</code>\n"
+      "x-intellij-html-description": "<p>contains the configuration needed for deploying with <code>kubectl apply</code></p>\n"
     },
     "LocalBuild": {
       "properties": {
@@ -272,7 +272,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository.",
-      "x-intellij-html-description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository.\n"
+      "x-intellij-html-description": "<p>contains the fields needed to do a build on the local docker daemon and optionally push to a repository.</p>\n"
     },
     "Manifest": {
       "properties": {
@@ -320,7 +320,7 @@
       ],
       "additionalProperties": false,
       "description": "top level config object that is parsed from a skaffold.yaml",
-      "x-intellij-html-description": "top level config object that is parsed from a skaffold.yaml\n"
+      "x-intellij-html-description": "<p>top level config object that is parsed from a skaffold.yaml</p>\n"
     }
   }
 }
diff --git a/docs/content/en/schemas/v1alpha2.json b/docs/content/en/schemas/v1alpha2.json
index 0dfd4ec9e5d..e6fe76e16dc 100755
--- a/docs/content/en/schemas/v1alpha2.json
+++ b/docs/content/en/schemas/v1alpha2.json
@@ -64,7 +64,7 @@
         }
       ],
       "description": "represents items that need to be built, along with the context in which they should be built.",
-      "x-intellij-html-description": "represents items that need to be built, along with the context in which they should be built.\n"
+      "x-intellij-html-description": "<p>represents items that need to be built, along with the context in which they should be built.</p>\n"
     },
     "ArtifactType": {
       "properties": {
@@ -180,7 +180,7 @@
         }
       ],
       "description": "contains all the configuration for the build steps",
-      "x-intellij-html-description": "contains all the configuration for the build steps\n"
+      "x-intellij-html-description": "<p>contains all the configuration for the build steps</p>\n"
     },
     "BuildType": {
       "properties": {
@@ -201,7 +201,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.",
-      "x-intellij-html-description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.\n"
+      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the build step. Only one field should be populated.</p>\n"
     },
     "DateTimeTagger": {
       "properties": {
@@ -218,7 +218,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the DateTime tagger.",
-      "x-intellij-html-description": "contains the configuration for the DateTime tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the DateTime tagger.</p>\n"
     },
     "DeployConfig": {
       "anyOf": [
@@ -260,7 +260,7 @@
         }
       ],
       "description": "contains all the configuration needed by the deploy steps",
-      "x-intellij-html-description": "contains all the configuration needed by the deploy steps\n"
+      "x-intellij-html-description": "<p>contains all the configuration needed by the deploy steps</p>\n"
     },
     "DeployType": {
       "properties": {
@@ -281,7 +281,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.",
-      "x-intellij-html-description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.\n"
+      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.</p>\n"
     },
     "DockerArtifact": {
       "properties": {
@@ -325,11 +325,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the envTemplate tagger.",
-      "x-intellij-html-description": "contains the configuration for the envTemplate tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the envTemplate tagger.</p>\n"
     },
     "GitTagger": {
       "description": "contains the configuration for the git tagger.",
-      "x-intellij-html-description": "contains the configuration for the git tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the git tagger.</p>\n"
     },
     "GoogleCloudBuild": {
       "properties": {
@@ -358,11 +358,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a remote build on Google Cloud Build.",
-      "x-intellij-html-description": "contains the fields needed to do a remote build on Google Cloud Build.\n"
+      "x-intellij-html-description": "<p>contains the fields needed to do a remote build on Google Cloud Build.</p>\n"
     },
     "HelmConventionConfig": {
       "description": "represents image config in the syntax of image.repository and image.tag",
-      "x-intellij-html-description": "represents image config in the syntax of image.repository and image.tag\n"
+      "x-intellij-html-description": "<p>represents image config in the syntax of image.repository and image.tag</p>\n"
     },
     "HelmDeploy": {
       "properties": {
@@ -378,7 +378,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with helm",
-      "x-intellij-html-description": "contains the configuration needed for deploying with helm\n"
+      "x-intellij-html-description": "<p>contains the configuration needed for deploying with helm</p>\n"
     },
     "HelmFQNConfig": {
       "properties": {
@@ -391,7 +391,7 @@
       ],
       "additionalProperties": false,
       "description": "represents image config to use the FullyQualifiedImageName as param to set",
-      "x-intellij-html-description": "represents image config to use the FullyQualifiedImageName as param to set\n"
+      "x-intellij-html-description": "<p>represents image config to use the FullyQualifiedImageName as param to set</p>\n"
     },
     "HelmImageConfig": {
       "properties": {
@@ -442,12 +442,12 @@
         "appVersion": {
           "type": "string",
           "description": "set the appVersion on the chart to this version",
-          "x-intellij-html-description": "set the appVersion on the chart to this version\n"
+          "x-intellij-html-description": "<p>set the appVersion on the chart to this version</p>\n"
         },
         "version": {
           "type": "string",
           "description": "sets the version on the chart to this semver version.",
-          "x-intellij-html-description": "sets the version on the chart to this semver version.\n"
+          "x-intellij-html-description": "<p>sets the version on the chart to this semver version.</p>\n"
         }
       },
       "preferredOrder": [
@@ -456,7 +456,7 @@
       ],
       "additionalProperties": false,
       "description": "represents parameters for packaging helm chart.",
-      "x-intellij-html-description": "represents parameters for packaging helm chart.\n"
+      "x-intellij-html-description": "<p>represents parameters for packaging helm chart.</p>\n"
     },
     "HelmRelease": {
       "properties": {
@@ -560,7 +560,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a on-cluster build using the kaniko image",
-      "x-intellij-html-description": "contains the fields needed to do a on-cluster build using the kaniko image\n"
+      "x-intellij-html-description": "<p>contains the fields needed to do a on-cluster build using the kaniko image</p>\n"
     },
     "KubectlDeploy": {
       "properties": {
@@ -589,7 +589,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with `kubectl apply`",
-      "x-intellij-html-description": "contains the configuration needed for deploying with <code>kubectl apply</code>\n"
+      "x-intellij-html-description": "<p>contains the configuration needed for deploying with <code>kubectl apply</code></p>\n"
     },
     "KubectlFlags": {
       "properties": {
@@ -622,7 +622,7 @@
       ],
       "additionalProperties": false,
       "description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).",
-      "x-intellij-html-description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).\n"
+      "x-intellij-html-description": "<p>describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).</p>\n"
     },
     "KustomizeDeploy": {
       "properties": {
@@ -660,7 +660,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository.",
-      "x-intellij-html-description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository.\n"
+      "x-intellij-html-description": "<p>contains the fields needed to do a build on the local docker daemon and optionally push to a repository.</p>\n"
     },
     "Profile": {
       "properties": {
@@ -681,11 +681,11 @@
       ],
       "additionalProperties": false,
       "description": "additional configuration that overrides default configuration when it is activated.",
-      "x-intellij-html-description": "additional configuration that overrides default configuration when it is activated.\n"
+      "x-intellij-html-description": "<p>additional configuration that overrides default configuration when it is activated.</p>\n"
     },
     "ShaTagger": {
       "description": "contains the configuration for the SHA tagger.",
-      "x-intellij-html-description": "contains the configuration for the SHA tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the SHA tagger.</p>\n"
     },
     "SkaffoldPipeline": {
       "properties": {
@@ -740,7 +740,7 @@
       ],
       "additionalProperties": false,
       "description": "contains all the configuration for the tagging step",
-      "x-intellij-html-description": "contains all the configuration for the tagging step\n"
+      "x-intellij-html-description": "<p>contains all the configuration for the tagging step</p>\n"
     }
   }
 }
diff --git a/docs/content/en/schemas/v1alpha3.json b/docs/content/en/schemas/v1alpha3.json
index 0af8a48cf4e..4cf6665d073 100755
--- a/docs/content/en/schemas/v1alpha3.json
+++ b/docs/content/en/schemas/v1alpha3.json
@@ -64,7 +64,7 @@
         }
       ],
       "description": "represents items that need to be built, along with the context in which they should be built.",
-      "x-intellij-html-description": "represents items that need to be built, along with the context in which they should be built.\n"
+      "x-intellij-html-description": "<p>represents items that need to be built, along with the context in which they should be built.</p>\n"
     },
     "ArtifactType": {
       "properties": {
@@ -180,7 +180,7 @@
         }
       ],
       "description": "contains all the configuration for the build steps",
-      "x-intellij-html-description": "contains all the configuration for the build steps\n"
+      "x-intellij-html-description": "<p>contains all the configuration for the build steps</p>\n"
     },
     "BuildType": {
       "properties": {
@@ -201,7 +201,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.",
-      "x-intellij-html-description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.\n"
+      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the build step. Only one field should be populated.</p>\n"
     },
     "DateTimeTagger": {
       "properties": {
@@ -218,7 +218,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the DateTime tagger.",
-      "x-intellij-html-description": "contains the configuration for the DateTime tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the DateTime tagger.</p>\n"
     },
     "DeployConfig": {
       "anyOf": [
@@ -260,7 +260,7 @@
         }
       ],
       "description": "contains all the configuration needed by the deploy steps",
-      "x-intellij-html-description": "contains all the configuration needed by the deploy steps\n"
+      "x-intellij-html-description": "<p>contains all the configuration needed by the deploy steps</p>\n"
     },
     "DeployType": {
       "properties": {
@@ -281,7 +281,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.",
-      "x-intellij-html-description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.\n"
+      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.</p>\n"
     },
     "DockerArtifact": {
       "properties": {
@@ -325,11 +325,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the envTemplate tagger.",
-      "x-intellij-html-description": "contains the configuration for the envTemplate tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the envTemplate tagger.</p>\n"
     },
     "GitTagger": {
       "description": "contains the configuration for the git tagger.",
-      "x-intellij-html-description": "contains the configuration for the git tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the git tagger.</p>\n"
     },
     "GoogleCloudBuild": {
       "properties": {
@@ -358,11 +358,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a remote build on Google Cloud Build.",
-      "x-intellij-html-description": "contains the fields needed to do a remote build on Google Cloud Build.\n"
+      "x-intellij-html-description": "<p>contains the fields needed to do a remote build on Google Cloud Build.</p>\n"
     },
     "HelmConventionConfig": {
       "description": "represents image config in the syntax of image.repository and image.tag",
-      "x-intellij-html-description": "represents image config in the syntax of image.repository and image.tag\n"
+      "x-intellij-html-description": "<p>represents image config in the syntax of image.repository and image.tag</p>\n"
     },
     "HelmDeploy": {
       "properties": {
@@ -378,7 +378,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with helm",
-      "x-intellij-html-description": "contains the configuration needed for deploying with helm\n"
+      "x-intellij-html-description": "<p>contains the configuration needed for deploying with helm</p>\n"
     },
     "HelmFQNConfig": {
       "properties": {
@@ -391,7 +391,7 @@
       ],
       "additionalProperties": false,
       "description": "represents image config to use the FullyQualifiedImageName as param to set",
-      "x-intellij-html-description": "represents image config to use the FullyQualifiedImageName as param to set\n"
+      "x-intellij-html-description": "<p>represents image config to use the FullyQualifiedImageName as param to set</p>\n"
     },
     "HelmImageConfig": {
       "properties": {
@@ -442,12 +442,12 @@
         "appVersion": {
           "type": "string",
           "description": "set the appVersion on the chart to this version",
-          "x-intellij-html-description": "set the appVersion on the chart to this version\n"
+          "x-intellij-html-description": "<p>set the appVersion on the chart to this version</p>\n"
         },
         "version": {
           "type": "string",
           "description": "sets the version on the chart to this semver version.",
-          "x-intellij-html-description": "sets the version on the chart to this semver version.\n"
+          "x-intellij-html-description": "<p>sets the version on the chart to this semver version.</p>\n"
         }
       },
       "preferredOrder": [
@@ -456,7 +456,7 @@
       ],
       "additionalProperties": false,
       "description": "represents parameters for packaging helm chart.",
-      "x-intellij-html-description": "represents parameters for packaging helm chart.\n"
+      "x-intellij-html-description": "<p>represents parameters for packaging helm chart.</p>\n"
     },
     "HelmRelease": {
       "properties": {
@@ -564,7 +564,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a on-cluster build using the kaniko image",
-      "x-intellij-html-description": "contains the fields needed to do a on-cluster build using the kaniko image\n"
+      "x-intellij-html-description": "<p>contains the fields needed to do a on-cluster build using the kaniko image</p>\n"
     },
     "KanikoBuildContext": {
       "properties": {
@@ -577,7 +577,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the different fields available to specify a kaniko build context",
-      "x-intellij-html-description": "contains the different fields available to specify a kaniko build context\n"
+      "x-intellij-html-description": "<p>contains the different fields available to specify a kaniko build context</p>\n"
     },
     "KubectlDeploy": {
       "properties": {
@@ -606,7 +606,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with `kubectl apply`",
-      "x-intellij-html-description": "contains the configuration needed for deploying with <code>kubectl apply</code>\n"
+      "x-intellij-html-description": "<p>contains the configuration needed for deploying with <code>kubectl apply</code></p>\n"
     },
     "KubectlFlags": {
       "properties": {
@@ -639,7 +639,7 @@
       ],
       "additionalProperties": false,
       "description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).",
-      "x-intellij-html-description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).\n"
+      "x-intellij-html-description": "<p>describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).</p>\n"
     },
     "KustomizeDeploy": {
       "properties": {
@@ -677,7 +677,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository.",
-      "x-intellij-html-description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository.\n"
+      "x-intellij-html-description": "<p>contains the fields needed to do a build on the local docker daemon and optionally push to a repository.</p>\n"
     },
     "Profile": {
       "properties": {
@@ -698,11 +698,11 @@
       ],
       "additionalProperties": false,
       "description": "additional configuration that overrides default configuration when it is activated.",
-      "x-intellij-html-description": "additional configuration that overrides default configuration when it is activated.\n"
+      "x-intellij-html-description": "<p>additional configuration that overrides default configuration when it is activated.</p>\n"
     },
     "ShaTagger": {
       "description": "contains the configuration for the SHA tagger.",
-      "x-intellij-html-description": "contains the configuration for the SHA tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the SHA tagger.</p>\n"
     },
     "SkaffoldPipeline": {
       "properties": {
@@ -757,7 +757,7 @@
       ],
       "additionalProperties": false,
       "description": "contains all the configuration for the tagging step",
-      "x-intellij-html-description": "contains all the configuration for the tagging step\n"
+      "x-intellij-html-description": "<p>contains all the configuration for the tagging step</p>\n"
     }
   }
 }
diff --git a/docs/content/en/schemas/v1alpha4.json b/docs/content/en/schemas/v1alpha4.json
index 864def27033..a85d4dce504 100755
--- a/docs/content/en/schemas/v1alpha4.json
+++ b/docs/content/en/schemas/v1alpha4.json
@@ -142,7 +142,7 @@
         }
       ],
       "description": "represents items that need to be built, along with the context in which they should be built.",
-      "x-intellij-html-description": "represents items that need to be built, along with the context in which they should be built.\n"
+      "x-intellij-html-description": "<p>represents items that need to be built, along with the context in which they should be built.</p>\n"
     },
     "ArtifactType": {
       "properties": {
@@ -178,7 +178,7 @@
       ],
       "additionalProperties": false,
       "description": "describes an artifact built with Bazel.",
-      "x-intellij-html-description": "describes an artifact built with Bazel.\n"
+      "x-intellij-html-description": "<p>describes an artifact built with Bazel.</p>\n"
     },
     "BuildConfig": {
       "anyOf": [
@@ -268,7 +268,7 @@
         }
       ],
       "description": "contains all the configuration for the build steps",
-      "x-intellij-html-description": "contains all the configuration for the build steps\n"
+      "x-intellij-html-description": "<p>contains all the configuration for the build steps</p>\n"
     },
     "BuildType": {
       "properties": {
@@ -289,7 +289,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.",
-      "x-intellij-html-description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.\n"
+      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the build step. Only one field should be populated.</p>\n"
     },
     "DateTimeTagger": {
       "properties": {
@@ -306,7 +306,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the DateTime tagger.",
-      "x-intellij-html-description": "contains the configuration for the DateTime tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the DateTime tagger.</p>\n"
     },
     "DeployConfig": {
       "anyOf": [
@@ -348,7 +348,7 @@
         }
       ],
       "description": "contains all the configuration needed by the deploy steps",
-      "x-intellij-html-description": "contains all the configuration needed by the deploy steps\n"
+      "x-intellij-html-description": "<p>contains all the configuration needed by the deploy steps</p>\n"
     },
     "DeployType": {
       "properties": {
@@ -369,7 +369,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.",
-      "x-intellij-html-description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.\n"
+      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.</p>\n"
     },
     "DockerArtifact": {
       "properties": {
@@ -402,7 +402,7 @@
       ],
       "additionalProperties": false,
       "description": "describes an artifact built from a Dockerfile, usually using `docker build`.",
-      "x-intellij-html-description": "describes an artifact built from a Dockerfile, usually using <code>docker build</code>.\n"
+      "x-intellij-html-description": "<p>describes an artifact built from a Dockerfile, usually using <code>docker build</code>.</p>\n"
     },
     "EnvTemplateTagger": {
       "properties": {
@@ -415,11 +415,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the envTemplate tagger.",
-      "x-intellij-html-description": "contains the configuration for the envTemplate tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the envTemplate tagger.</p>\n"
     },
     "GitTagger": {
       "description": "contains the configuration for the git tagger.",
-      "x-intellij-html-description": "contains the configuration for the git tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the git tagger.</p>\n"
     },
     "GoogleCloudBuild": {
       "properties": {
@@ -448,11 +448,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a remote build on Google Cloud Build.",
-      "x-intellij-html-description": "contains the fields needed to do a remote build on Google Cloud Build.\n"
+      "x-intellij-html-description": "<p>contains the fields needed to do a remote build on Google Cloud Build.</p>\n"
     },
     "HelmConventionConfig": {
       "description": "represents image config in the syntax of image.repository and image.tag",
-      "x-intellij-html-description": "represents image config in the syntax of image.repository and image.tag\n"
+      "x-intellij-html-description": "<p>represents image config in the syntax of image.repository and image.tag</p>\n"
     },
     "HelmDeploy": {
       "properties": {
@@ -468,7 +468,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with helm",
-      "x-intellij-html-description": "contains the configuration needed for deploying with helm\n"
+      "x-intellij-html-description": "<p>contains the configuration needed for deploying with helm</p>\n"
     },
     "HelmFQNConfig": {
       "properties": {
@@ -481,7 +481,7 @@
       ],
       "additionalProperties": false,
       "description": "represents image config to use the FullyQualifiedImageName as param to set",
-      "x-intellij-html-description": "represents image config to use the FullyQualifiedImageName as param to set\n"
+      "x-intellij-html-description": "<p>represents image config to use the FullyQualifiedImageName as param to set</p>\n"
     },
     "HelmImageConfig": {
       "properties": {
@@ -532,12 +532,12 @@
         "appVersion": {
           "type": "string",
           "description": "set the appVersion on the chart to this version",
-          "x-intellij-html-description": "set the appVersion on the chart to this version\n"
+          "x-intellij-html-description": "<p>set the appVersion on the chart to this version</p>\n"
         },
         "version": {
           "type": "string",
           "description": "sets the version on the chart to this semver version.",
-          "x-intellij-html-description": "sets the version on the chart to this semver version.\n"
+          "x-intellij-html-description": "<p>sets the version on the chart to this semver version.</p>\n"
         }
       },
       "preferredOrder": [
@@ -546,7 +546,7 @@
       ],
       "additionalProperties": false,
       "description": "represents parameters for packaging helm chart.",
-      "x-intellij-html-description": "represents parameters for packaging helm chart.\n"
+      "x-intellij-html-description": "<p>represents parameters for packaging helm chart.</p>\n"
     },
     "HelmRelease": {
       "properties": {
@@ -632,7 +632,7 @@
         "project": {
           "type": "string",
           "description": "Only multi-module",
-          "x-intellij-html-description": "Only multi-module\n"
+          "x-intellij-html-description": "<p>Only multi-module</p>\n"
         }
       },
       "preferredOrder": [
@@ -645,7 +645,7 @@
         "module": {
           "type": "string",
           "description": "Only multi-module",
-          "x-intellij-html-description": "Only multi-module\n"
+          "x-intellij-html-description": "<p>Only multi-module</p>\n"
         },
         "profile": {
           "type": "string"
@@ -688,7 +688,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a on-cluster build using the kaniko image",
-      "x-intellij-html-description": "contains the fields needed to do a on-cluster build using the kaniko image\n"
+      "x-intellij-html-description": "<p>contains the fields needed to do a on-cluster build using the kaniko image</p>\n"
     },
     "KanikoBuildContext": {
       "properties": {
@@ -705,7 +705,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the different fields available to specify a kaniko build context",
-      "x-intellij-html-description": "contains the different fields available to specify a kaniko build context\n"
+      "x-intellij-html-description": "<p>contains the different fields available to specify a kaniko build context</p>\n"
     },
     "KubectlDeploy": {
       "properties": {
@@ -734,7 +734,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with `kubectl apply`",
-      "x-intellij-html-description": "contains the configuration needed for deploying with <code>kubectl apply</code>\n"
+      "x-intellij-html-description": "<p>contains the configuration needed for deploying with <code>kubectl apply</code></p>\n"
     },
     "KubectlFlags": {
       "properties": {
@@ -767,7 +767,7 @@
       ],
       "additionalProperties": false,
       "description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).",
-      "x-intellij-html-description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).\n"
+      "x-intellij-html-description": "<p>describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).</p>\n"
     },
     "KustomizeDeploy": {
       "properties": {
@@ -784,7 +784,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with kustomize.",
-      "x-intellij-html-description": "contains the configuration needed for deploying with kustomize.\n"
+      "x-intellij-html-description": "<p>contains the configuration needed for deploying with kustomize.</p>\n"
     },
     "LocalBuild": {
       "properties": {
@@ -807,11 +807,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository.",
-      "x-intellij-html-description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository.\n"
+      "x-intellij-html-description": "<p>contains the fields needed to do a build on the local docker daemon and optionally push to a repository.</p>\n"
     },
     "LocalDir": {
       "description": "represents the local directory kaniko build context",
-      "x-intellij-html-description": "represents the local directory kaniko build context\n"
+      "x-intellij-html-description": "<p>represents the local directory kaniko build context</p>\n"
     },
     "Profile": {
       "properties": {
@@ -839,11 +839,11 @@
       ],
       "additionalProperties": false,
       "description": "additional configuration that overrides default configuration when it is activated.",
-      "x-intellij-html-description": "additional configuration that overrides default configuration when it is activated.\n"
+      "x-intellij-html-description": "<p>additional configuration that overrides default configuration when it is activated.</p>\n"
     },
     "ShaTagger": {
       "description": "contains the configuration for the SHA tagger.",
-      "x-intellij-html-description": "contains the configuration for the SHA tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the SHA tagger.</p>\n"
     },
     "SkaffoldPipeline": {
       "properties": {
@@ -902,7 +902,7 @@
       ],
       "additionalProperties": false,
       "description": "contains all the configuration for the tagging step",
-      "x-intellij-html-description": "contains all the configuration for the tagging step\n"
+      "x-intellij-html-description": "<p>contains all the configuration for the tagging step</p>\n"
     },
     "TestCase": {
       "properties": {
@@ -923,7 +923,7 @@
       ],
       "additionalProperties": false,
       "description": "a struct containing all the specified test configuration for an image.",
-      "x-intellij-html-description": "a struct containing all the specified test configuration for an image.\n"
+      "x-intellij-html-description": "<p>a struct containing all the specified test configuration for an image.</p>\n"
     },
     "TestConfig": {
       "items": {
diff --git a/docs/content/en/schemas/v1alpha5.json b/docs/content/en/schemas/v1alpha5.json
index a11dedc8431..fb548dbc3a5 100755
--- a/docs/content/en/schemas/v1alpha5.json
+++ b/docs/content/en/schemas/v1alpha5.json
@@ -142,7 +142,7 @@
         }
       ],
       "description": "represents items that need to be built, along with the context in which they should be built.",
-      "x-intellij-html-description": "represents items that need to be built, along with the context in which they should be built.\n"
+      "x-intellij-html-description": "<p>represents items that need to be built, along with the context in which they should be built.</p>\n"
     },
     "ArtifactType": {
       "properties": {
@@ -190,7 +190,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a build on Azure Container Registry",
-      "x-intellij-html-description": "contains the fields needed to do a build on Azure Container Registry\n"
+      "x-intellij-html-description": "<p>contains the fields needed to do a build on Azure Container Registry</p>\n"
     },
     "BazelArtifact": {
       "properties": {
@@ -203,7 +203,7 @@
       ],
       "additionalProperties": false,
       "description": "describes an artifact built with Bazel.",
-      "x-intellij-html-description": "describes an artifact built with Bazel.\n"
+      "x-intellij-html-description": "<p>describes an artifact built with Bazel.</p>\n"
     },
     "BuildConfig": {
       "anyOf": [
@@ -315,7 +315,7 @@
         }
       ],
       "description": "contains all the configuration for the build steps",
-      "x-intellij-html-description": "contains all the configuration for the build steps\n"
+      "x-intellij-html-description": "<p>contains all the configuration for the build steps</p>\n"
     },
     "BuildType": {
       "properties": {
@@ -340,7 +340,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.",
-      "x-intellij-html-description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.\n"
+      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the build step. Only one field should be populated.</p>\n"
     },
     "DateTimeTagger": {
       "properties": {
@@ -357,7 +357,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the DateTime tagger.",
-      "x-intellij-html-description": "contains the configuration for the DateTime tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the DateTime tagger.</p>\n"
     },
     "DeployConfig": {
       "anyOf": [
@@ -399,7 +399,7 @@
         }
       ],
       "description": "contains all the configuration needed by the deploy steps",
-      "x-intellij-html-description": "contains all the configuration needed by the deploy steps\n"
+      "x-intellij-html-description": "<p>contains all the configuration needed by the deploy steps</p>\n"
     },
     "DeployType": {
       "properties": {
@@ -420,7 +420,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.",
-      "x-intellij-html-description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.\n"
+      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.</p>\n"
     },
     "DockerArtifact": {
       "properties": {
@@ -453,7 +453,7 @@
       ],
       "additionalProperties": false,
       "description": "describes an artifact built from a Dockerfile, usually using `docker build`.",
-      "x-intellij-html-description": "describes an artifact built from a Dockerfile, usually using <code>docker build</code>.\n"
+      "x-intellij-html-description": "<p>describes an artifact built from a Dockerfile, usually using <code>docker build</code>.</p>\n"
     },
     "EnvTemplateTagger": {
       "properties": {
@@ -466,11 +466,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the envTemplate tagger.",
-      "x-intellij-html-description": "contains the configuration for the envTemplate tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the envTemplate tagger.</p>\n"
     },
     "GitTagger": {
       "description": "contains the configuration for the git tagger.",
-      "x-intellij-html-description": "contains the configuration for the git tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the git tagger.</p>\n"
     },
     "GoogleCloudBuild": {
       "properties": {
@@ -499,11 +499,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a remote build on Google Cloud Build.",
-      "x-intellij-html-description": "contains the fields needed to do a remote build on Google Cloud Build.\n"
+      "x-intellij-html-description": "<p>contains the fields needed to do a remote build on Google Cloud Build.</p>\n"
     },
     "HelmConventionConfig": {
       "description": "represents image config in the syntax of image.repository and image.tag",
-      "x-intellij-html-description": "represents image config in the syntax of image.repository and image.tag\n"
+      "x-intellij-html-description": "<p>represents image config in the syntax of image.repository and image.tag</p>\n"
     },
     "HelmDeploy": {
       "properties": {
@@ -519,7 +519,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with helm",
-      "x-intellij-html-description": "contains the configuration needed for deploying with helm\n"
+      "x-intellij-html-description": "<p>contains the configuration needed for deploying with helm</p>\n"
     },
     "HelmFQNConfig": {
       "properties": {
@@ -532,7 +532,7 @@
       ],
       "additionalProperties": false,
       "description": "represents image config to use the FullyQualifiedImageName as param to set",
-      "x-intellij-html-description": "represents image config to use the FullyQualifiedImageName as param to set\n"
+      "x-intellij-html-description": "<p>represents image config to use the FullyQualifiedImageName as param to set</p>\n"
     },
     "HelmImageConfig": {
       "properties": {
@@ -583,12 +583,12 @@
         "appVersion": {
           "type": "string",
           "description": "set the appVersion on the chart to this version",
-          "x-intellij-html-description": "set the appVersion on the chart to this version\n"
+          "x-intellij-html-description": "<p>set the appVersion on the chart to this version</p>\n"
         },
         "version": {
           "type": "string",
           "description": "sets the version on the chart to this semver version.",
-          "x-intellij-html-description": "sets the version on the chart to this semver version.\n"
+          "x-intellij-html-description": "<p>sets the version on the chart to this semver version.</p>\n"
         }
       },
       "preferredOrder": [
@@ -597,7 +597,7 @@
       ],
       "additionalProperties": false,
       "description": "represents parameters for packaging helm chart.",
-      "x-intellij-html-description": "represents parameters for packaging helm chart.\n"
+      "x-intellij-html-description": "<p>represents parameters for packaging helm chart.</p>\n"
     },
     "HelmRelease": {
       "properties": {
@@ -683,7 +683,7 @@
         "project": {
           "type": "string",
           "description": "Only multi-module",
-          "x-intellij-html-description": "Only multi-module\n"
+          "x-intellij-html-description": "<p>Only multi-module</p>\n"
         }
       },
       "preferredOrder": [
@@ -696,7 +696,7 @@
         "module": {
           "type": "string",
           "description": "Only multi-module",
-          "x-intellij-html-description": "Only multi-module\n"
+          "x-intellij-html-description": "<p>Only multi-module</p>\n"
         },
         "profile": {
           "type": "string"
@@ -739,7 +739,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a on-cluster build using the kaniko image",
-      "x-intellij-html-description": "contains the fields needed to do a on-cluster build using the kaniko image\n"
+      "x-intellij-html-description": "<p>contains the fields needed to do a on-cluster build using the kaniko image</p>\n"
     },
     "KanikoBuildContext": {
       "properties": {
@@ -756,7 +756,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the different fields available to specify a kaniko build context",
-      "x-intellij-html-description": "contains the different fields available to specify a kaniko build context\n"
+      "x-intellij-html-description": "<p>contains the different fields available to specify a kaniko build context</p>\n"
     },
     "KubectlDeploy": {
       "properties": {
@@ -785,7 +785,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with `kubectl apply`",
-      "x-intellij-html-description": "contains the configuration needed for deploying with <code>kubectl apply</code>\n"
+      "x-intellij-html-description": "<p>contains the configuration needed for deploying with <code>kubectl apply</code></p>\n"
     },
     "KubectlFlags": {
       "properties": {
@@ -818,7 +818,7 @@
       ],
       "additionalProperties": false,
       "description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).",
-      "x-intellij-html-description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).\n"
+      "x-intellij-html-description": "<p>describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).</p>\n"
     },
     "KustomizeDeploy": {
       "properties": {
@@ -835,7 +835,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with kustomize.",
-      "x-intellij-html-description": "contains the configuration needed for deploying with kustomize.\n"
+      "x-intellij-html-description": "<p>contains the configuration needed for deploying with kustomize.</p>\n"
     },
     "LocalBuild": {
       "properties": {
@@ -858,11 +858,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository.",
-      "x-intellij-html-description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository.\n"
+      "x-intellij-html-description": "<p>contains the fields needed to do a build on the local docker daemon and optionally push to a repository.</p>\n"
     },
     "LocalDir": {
       "description": "represents the local directory kaniko build context",
-      "x-intellij-html-description": "represents the local directory kaniko build context\n"
+      "x-intellij-html-description": "<p>represents the local directory kaniko build context</p>\n"
     },
     "Profile": {
       "properties": {
@@ -887,11 +887,11 @@
       ],
       "additionalProperties": false,
       "description": "additional configuration that overrides default configuration when it is activated.",
-      "x-intellij-html-description": "additional configuration that overrides default configuration when it is activated.\n"
+      "x-intellij-html-description": "<p>additional configuration that overrides default configuration when it is activated.</p>\n"
     },
     "ShaTagger": {
       "description": "contains the configuration for the SHA tagger.",
-      "x-intellij-html-description": "contains the configuration for the SHA tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the SHA tagger.</p>\n"
     },
     "SkaffoldPipeline": {
       "properties": {
@@ -950,7 +950,7 @@
       ],
       "additionalProperties": false,
       "description": "contains all the configuration for the tagging step",
-      "x-intellij-html-description": "contains all the configuration for the tagging step\n"
+      "x-intellij-html-description": "<p>contains all the configuration for the tagging step</p>\n"
     },
     "TestCase": {
       "properties": {
@@ -971,7 +971,7 @@
       ],
       "additionalProperties": false,
       "description": "a struct containing all the specified test configuration for an image.",
-      "x-intellij-html-description": "a struct containing all the specified test configuration for an image.\n"
+      "x-intellij-html-description": "<p>a struct containing all the specified test configuration for an image.</p>\n"
     },
     "TestConfig": {
       "items": {
diff --git a/docs/content/en/schemas/v1beta1.json b/docs/content/en/schemas/v1beta1.json
index 6a7363cf70a..d2df595ee51 100755
--- a/docs/content/en/schemas/v1beta1.json
+++ b/docs/content/en/schemas/v1beta1.json
@@ -142,7 +142,7 @@
         }
       ],
       "description": "represents items that need to be built, along with the context in which they should be built.",
-      "x-intellij-html-description": "represents items that need to be built, along with the context in which they should be built.\n"
+      "x-intellij-html-description": "<p>represents items that need to be built, along with the context in which they should be built.</p>\n"
     },
     "ArtifactType": {
       "properties": {
@@ -186,7 +186,7 @@
       ],
       "additionalProperties": false,
       "description": "describes an artifact built with Bazel.",
-      "x-intellij-html-description": "describes an artifact built with Bazel.\n"
+      "x-intellij-html-description": "<p>describes an artifact built with Bazel.</p>\n"
     },
     "BuildConfig": {
       "anyOf": [
@@ -276,7 +276,7 @@
         }
       ],
       "description": "contains all the configuration for the build steps",
-      "x-intellij-html-description": "contains all the configuration for the build steps\n"
+      "x-intellij-html-description": "<p>contains all the configuration for the build steps</p>\n"
     },
     "BuildType": {
       "properties": {
@@ -297,7 +297,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.",
-      "x-intellij-html-description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.\n"
+      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the build step. Only one field should be populated.</p>\n"
     },
     "DateTimeTagger": {
       "properties": {
@@ -314,7 +314,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the DateTime tagger.",
-      "x-intellij-html-description": "contains the configuration for the DateTime tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the DateTime tagger.</p>\n"
     },
     "DeployConfig": {
       "anyOf": [
@@ -356,7 +356,7 @@
         }
       ],
       "description": "contains all the configuration needed by the deploy steps",
-      "x-intellij-html-description": "contains all the configuration needed by the deploy steps\n"
+      "x-intellij-html-description": "<p>contains all the configuration needed by the deploy steps</p>\n"
     },
     "DeployType": {
       "properties": {
@@ -377,7 +377,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.",
-      "x-intellij-html-description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.\n"
+      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.</p>\n"
     },
     "DockerArtifact": {
       "properties": {
@@ -410,7 +410,7 @@
       ],
       "additionalProperties": false,
       "description": "describes an artifact built from a Dockerfile, usually using `docker build`.",
-      "x-intellij-html-description": "describes an artifact built from a Dockerfile, usually using <code>docker build</code>.\n"
+      "x-intellij-html-description": "<p>describes an artifact built from a Dockerfile, usually using <code>docker build</code>.</p>\n"
     },
     "EnvTemplateTagger": {
       "properties": {
@@ -423,11 +423,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the envTemplate tagger.",
-      "x-intellij-html-description": "contains the configuration for the envTemplate tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the envTemplate tagger.</p>\n"
     },
     "GitTagger": {
       "description": "contains the configuration for the git tagger.",
-      "x-intellij-html-description": "contains the configuration for the git tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the git tagger.</p>\n"
     },
     "GoogleCloudBuild": {
       "properties": {
@@ -456,11 +456,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a remote build on Google Cloud Build.",
-      "x-intellij-html-description": "contains the fields needed to do a remote build on Google Cloud Build.\n"
+      "x-intellij-html-description": "<p>contains the fields needed to do a remote build on Google Cloud Build.</p>\n"
     },
     "HelmConventionConfig": {
       "description": "represents image config in the syntax of image.repository and image.tag",
-      "x-intellij-html-description": "represents image config in the syntax of image.repository and image.tag\n"
+      "x-intellij-html-description": "<p>represents image config in the syntax of image.repository and image.tag</p>\n"
     },
     "HelmDeploy": {
       "properties": {
@@ -476,7 +476,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with helm",
-      "x-intellij-html-description": "contains the configuration needed for deploying with helm\n"
+      "x-intellij-html-description": "<p>contains the configuration needed for deploying with helm</p>\n"
     },
     "HelmFQNConfig": {
       "properties": {
@@ -489,7 +489,7 @@
       ],
       "additionalProperties": false,
       "description": "represents image config to use the FullyQualifiedImageName as param to set",
-      "x-intellij-html-description": "represents image config to use the FullyQualifiedImageName as param to set\n"
+      "x-intellij-html-description": "<p>represents image config to use the FullyQualifiedImageName as param to set</p>\n"
     },
     "HelmImageConfig": {
       "properties": {
@@ -540,12 +540,12 @@
         "appVersion": {
           "type": "string",
           "description": "set the appVersion on the chart to this version",
-          "x-intellij-html-description": "set the appVersion on the chart to this version\n"
+          "x-intellij-html-description": "<p>set the appVersion on the chart to this version</p>\n"
         },
         "version": {
           "type": "string",
           "description": "sets the version on the chart to this semver version.",
-          "x-intellij-html-description": "sets the version on the chart to this semver version.\n"
+          "x-intellij-html-description": "<p>sets the version on the chart to this semver version.</p>\n"
         }
       },
       "preferredOrder": [
@@ -554,7 +554,7 @@
       ],
       "additionalProperties": false,
       "description": "represents parameters for packaging helm chart.",
-      "x-intellij-html-description": "represents parameters for packaging helm chart.\n"
+      "x-intellij-html-description": "<p>represents parameters for packaging helm chart.</p>\n"
     },
     "HelmRelease": {
       "properties": {
@@ -640,7 +640,7 @@
         "project": {
           "type": "string",
           "description": "Only multi-module",
-          "x-intellij-html-description": "Only multi-module\n"
+          "x-intellij-html-description": "<p>Only multi-module</p>\n"
         }
       },
       "preferredOrder": [
@@ -653,7 +653,7 @@
         "module": {
           "type": "string",
           "description": "Only multi-module",
-          "x-intellij-html-description": "Only multi-module\n"
+          "x-intellij-html-description": "<p>Only multi-module</p>\n"
         },
         "profile": {
           "type": "string"
@@ -700,7 +700,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a on-cluster build using the kaniko image",
-      "x-intellij-html-description": "contains the fields needed to do a on-cluster build using the kaniko image\n"
+      "x-intellij-html-description": "<p>contains the fields needed to do a on-cluster build using the kaniko image</p>\n"
     },
     "KanikoBuildContext": {
       "properties": {
@@ -717,7 +717,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the different fields available to specify a kaniko build context",
-      "x-intellij-html-description": "contains the different fields available to specify a kaniko build context\n"
+      "x-intellij-html-description": "<p>contains the different fields available to specify a kaniko build context</p>\n"
     },
     "KanikoCache": {
       "properties": {
@@ -730,7 +730,7 @@
       ],
       "additionalProperties": false,
       "description": "contains fields related to kaniko caching",
-      "x-intellij-html-description": "contains fields related to kaniko caching\n"
+      "x-intellij-html-description": "<p>contains fields related to kaniko caching</p>\n"
     },
     "KubectlDeploy": {
       "properties": {
@@ -759,7 +759,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with `kubectl apply`",
-      "x-intellij-html-description": "contains the configuration needed for deploying with <code>kubectl apply</code>\n"
+      "x-intellij-html-description": "<p>contains the configuration needed for deploying with <code>kubectl apply</code></p>\n"
     },
     "KubectlFlags": {
       "properties": {
@@ -792,7 +792,7 @@
       ],
       "additionalProperties": false,
       "description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).",
-      "x-intellij-html-description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).\n"
+      "x-intellij-html-description": "<p>describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).</p>\n"
     },
     "KustomizeDeploy": {
       "properties": {
@@ -809,7 +809,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with kustomize.",
-      "x-intellij-html-description": "contains the configuration needed for deploying with kustomize.\n"
+      "x-intellij-html-description": "<p>contains the configuration needed for deploying with kustomize.</p>\n"
     },
     "LocalBuild": {
       "properties": {
@@ -832,11 +832,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository.",
-      "x-intellij-html-description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository.\n"
+      "x-intellij-html-description": "<p>contains the fields needed to do a build on the local docker daemon and optionally push to a repository.</p>\n"
     },
     "LocalDir": {
       "description": "represents the local directory kaniko build context",
-      "x-intellij-html-description": "represents the local directory kaniko build context\n"
+      "x-intellij-html-description": "<p>represents the local directory kaniko build context</p>\n"
     },
     "Profile": {
       "properties": {
@@ -861,11 +861,11 @@
       ],
       "additionalProperties": false,
       "description": "additional configuration that overrides default configuration when it is activated.",
-      "x-intellij-html-description": "additional configuration that overrides default configuration when it is activated.\n"
+      "x-intellij-html-description": "<p>additional configuration that overrides default configuration when it is activated.</p>\n"
     },
     "ShaTagger": {
       "description": "contains the configuration for the SHA tagger.",
-      "x-intellij-html-description": "contains the configuration for the SHA tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the SHA tagger.</p>\n"
     },
     "SkaffoldPipeline": {
       "properties": {
@@ -924,7 +924,7 @@
       ],
       "additionalProperties": false,
       "description": "contains all the configuration for the tagging step",
-      "x-intellij-html-description": "contains all the configuration for the tagging step\n"
+      "x-intellij-html-description": "<p>contains all the configuration for the tagging step</p>\n"
     },
     "TestCase": {
       "properties": {
@@ -945,7 +945,7 @@
       ],
       "additionalProperties": false,
       "description": "a struct containing all the specified test configuration for an image.",
-      "x-intellij-html-description": "a struct containing all the specified test configuration for an image.\n"
+      "x-intellij-html-description": "<p>a struct containing all the specified test configuration for an image.</p>\n"
     },
     "TestConfig": {
       "items": {
diff --git a/docs/content/en/schemas/v1beta2.json b/docs/content/en/schemas/v1beta2.json
index 27af8d5f7c0..1ed125ae090 100755
--- a/docs/content/en/schemas/v1beta2.json
+++ b/docs/content/en/schemas/v1beta2.json
@@ -142,7 +142,7 @@
         }
       ],
       "description": "represents items that need to be built, along with the context in which they should be built.",
-      "x-intellij-html-description": "represents items that need to be built, along with the context in which they should be built.\n"
+      "x-intellij-html-description": "<p>represents items that need to be built, along with the context in which they should be built.</p>\n"
     },
     "ArtifactType": {
       "properties": {
@@ -186,7 +186,7 @@
       ],
       "additionalProperties": false,
       "description": "describes an artifact built with Bazel.",
-      "x-intellij-html-description": "describes an artifact built with Bazel.\n"
+      "x-intellij-html-description": "<p>describes an artifact built with Bazel.</p>\n"
     },
     "BuildConfig": {
       "anyOf": [
@@ -276,7 +276,7 @@
         }
       ],
       "description": "contains all the configuration for the build steps",
-      "x-intellij-html-description": "contains all the configuration for the build steps\n"
+      "x-intellij-html-description": "<p>contains all the configuration for the build steps</p>\n"
     },
     "BuildType": {
       "properties": {
@@ -297,7 +297,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.",
-      "x-intellij-html-description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.\n"
+      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the build step. Only one field should be populated.</p>\n"
     },
     "DateTimeTagger": {
       "properties": {
@@ -314,7 +314,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the DateTime tagger.",
-      "x-intellij-html-description": "contains the configuration for the DateTime tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the DateTime tagger.</p>\n"
     },
     "DeployConfig": {
       "anyOf": [
@@ -356,7 +356,7 @@
         }
       ],
       "description": "contains all the configuration needed by the deploy steps",
-      "x-intellij-html-description": "contains all the configuration needed by the deploy steps\n"
+      "x-intellij-html-description": "<p>contains all the configuration needed by the deploy steps</p>\n"
     },
     "DeployType": {
       "properties": {
@@ -377,7 +377,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.",
-      "x-intellij-html-description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.\n"
+      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.</p>\n"
     },
     "DockerArtifact": {
       "properties": {
@@ -410,7 +410,7 @@
       ],
       "additionalProperties": false,
       "description": "describes an artifact built from a Dockerfile, usually using `docker build`.",
-      "x-intellij-html-description": "describes an artifact built from a Dockerfile, usually using <code>docker build</code>.\n"
+      "x-intellij-html-description": "<p>describes an artifact built from a Dockerfile, usually using <code>docker build</code>.</p>\n"
     },
     "EnvTemplateTagger": {
       "properties": {
@@ -423,11 +423,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the envTemplate tagger.",
-      "x-intellij-html-description": "contains the configuration for the envTemplate tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the envTemplate tagger.</p>\n"
     },
     "GitTagger": {
       "description": "contains the configuration for the git tagger.",
-      "x-intellij-html-description": "contains the configuration for the git tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the git tagger.</p>\n"
     },
     "GoogleCloudBuild": {
       "properties": {
@@ -456,11 +456,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a remote build on Google Cloud Build.",
-      "x-intellij-html-description": "contains the fields needed to do a remote build on Google Cloud Build.\n"
+      "x-intellij-html-description": "<p>contains the fields needed to do a remote build on Google Cloud Build.</p>\n"
     },
     "HelmConventionConfig": {
       "description": "represents image config in the syntax of image.repository and image.tag",
-      "x-intellij-html-description": "represents image config in the syntax of image.repository and image.tag\n"
+      "x-intellij-html-description": "<p>represents image config in the syntax of image.repository and image.tag</p>\n"
     },
     "HelmDeploy": {
       "properties": {
@@ -476,7 +476,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with helm",
-      "x-intellij-html-description": "contains the configuration needed for deploying with helm\n"
+      "x-intellij-html-description": "<p>contains the configuration needed for deploying with helm</p>\n"
     },
     "HelmFQNConfig": {
       "properties": {
@@ -489,7 +489,7 @@
       ],
       "additionalProperties": false,
       "description": "represents image config to use the FullyQualifiedImageName as param to set",
-      "x-intellij-html-description": "represents image config to use the FullyQualifiedImageName as param to set\n"
+      "x-intellij-html-description": "<p>represents image config to use the FullyQualifiedImageName as param to set</p>\n"
     },
     "HelmImageConfig": {
       "properties": {
@@ -540,12 +540,12 @@
         "appVersion": {
           "type": "string",
           "description": "set the appVersion on the chart to this version",
-          "x-intellij-html-description": "set the appVersion on the chart to this version\n"
+          "x-intellij-html-description": "<p>set the appVersion on the chart to this version</p>\n"
         },
         "version": {
           "type": "string",
           "description": "sets the version on the chart to this semver version.",
-          "x-intellij-html-description": "sets the version on the chart to this semver version.\n"
+          "x-intellij-html-description": "<p>sets the version on the chart to this semver version.</p>\n"
         }
       },
       "preferredOrder": [
@@ -554,7 +554,7 @@
       ],
       "additionalProperties": false,
       "description": "represents parameters for packaging helm chart.",
-      "x-intellij-html-description": "represents parameters for packaging helm chart.\n"
+      "x-intellij-html-description": "<p>represents parameters for packaging helm chart.</p>\n"
     },
     "HelmRelease": {
       "properties": {
@@ -640,7 +640,7 @@
         "project": {
           "type": "string",
           "description": "Only multi-module",
-          "x-intellij-html-description": "Only multi-module\n"
+          "x-intellij-html-description": "<p>Only multi-module</p>\n"
         }
       },
       "preferredOrder": [
@@ -653,7 +653,7 @@
         "module": {
           "type": "string",
           "description": "Only multi-module",
-          "x-intellij-html-description": "Only multi-module\n"
+          "x-intellij-html-description": "<p>Only multi-module</p>\n"
         },
         "profile": {
           "type": "string"
@@ -708,7 +708,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a on-cluster build using the kaniko image",
-      "x-intellij-html-description": "contains the fields needed to do a on-cluster build using the kaniko image\n"
+      "x-intellij-html-description": "<p>contains the fields needed to do a on-cluster build using the kaniko image</p>\n"
     },
     "KanikoBuildContext": {
       "properties": {
@@ -725,7 +725,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the different fields available to specify a kaniko build context",
-      "x-intellij-html-description": "contains the different fields available to specify a kaniko build context\n"
+      "x-intellij-html-description": "<p>contains the different fields available to specify a kaniko build context</p>\n"
     },
     "KanikoCache": {
       "properties": {
@@ -738,7 +738,7 @@
       ],
       "additionalProperties": false,
       "description": "contains fields related to kaniko caching",
-      "x-intellij-html-description": "contains fields related to kaniko caching\n"
+      "x-intellij-html-description": "<p>contains fields related to kaniko caching</p>\n"
     },
     "KubectlDeploy": {
       "properties": {
@@ -767,7 +767,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with `kubectl apply`",
-      "x-intellij-html-description": "contains the configuration needed for deploying with <code>kubectl apply</code>\n"
+      "x-intellij-html-description": "<p>contains the configuration needed for deploying with <code>kubectl apply</code></p>\n"
     },
     "KubectlFlags": {
       "properties": {
@@ -800,7 +800,7 @@
       ],
       "additionalProperties": false,
       "description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).",
-      "x-intellij-html-description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).\n"
+      "x-intellij-html-description": "<p>describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).</p>\n"
     },
     "KustomizeDeploy": {
       "properties": {
@@ -817,7 +817,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with kustomize.",
-      "x-intellij-html-description": "contains the configuration needed for deploying with kustomize.\n"
+      "x-intellij-html-description": "<p>contains the configuration needed for deploying with kustomize.</p>\n"
     },
     "LocalBuild": {
       "properties": {
@@ -840,11 +840,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository.",
-      "x-intellij-html-description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository.\n"
+      "x-intellij-html-description": "<p>contains the fields needed to do a build on the local docker daemon and optionally push to a repository.</p>\n"
     },
     "LocalDir": {
       "description": "represents the local directory kaniko build context",
-      "x-intellij-html-description": "represents the local directory kaniko build context\n"
+      "x-intellij-html-description": "<p>represents the local directory kaniko build context</p>\n"
     },
     "Profile": {
       "properties": {
@@ -869,11 +869,11 @@
       ],
       "additionalProperties": false,
       "description": "additional configuration that overrides default configuration when it is activated.",
-      "x-intellij-html-description": "additional configuration that overrides default configuration when it is activated.\n"
+      "x-intellij-html-description": "<p>additional configuration that overrides default configuration when it is activated.</p>\n"
     },
     "ShaTagger": {
       "description": "contains the configuration for the SHA tagger.",
-      "x-intellij-html-description": "contains the configuration for the SHA tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the SHA tagger.</p>\n"
     },
     "SkaffoldPipeline": {
       "properties": {
@@ -932,7 +932,7 @@
       ],
       "additionalProperties": false,
       "description": "contains all the configuration for the tagging step",
-      "x-intellij-html-description": "contains all the configuration for the tagging step\n"
+      "x-intellij-html-description": "<p>contains all the configuration for the tagging step</p>\n"
     },
     "TestCase": {
       "properties": {
@@ -953,7 +953,7 @@
       ],
       "additionalProperties": false,
       "description": "a struct containing all the specified test configuration for an image.",
-      "x-intellij-html-description": "a struct containing all the specified test configuration for an image.\n"
+      "x-intellij-html-description": "<p>a struct containing all the specified test configuration for an image.</p>\n"
     },
     "TestConfig": {
       "items": {
diff --git a/docs/content/en/schemas/v1beta3.json b/docs/content/en/schemas/v1beta3.json
index e08ce2e96f8..57adfabf3ab 100755
--- a/docs/content/en/schemas/v1beta3.json
+++ b/docs/content/en/schemas/v1beta3.json
@@ -142,7 +142,7 @@
         }
       ],
       "description": "represents items that need to be built, along with the context in which they should be built.",
-      "x-intellij-html-description": "represents items that need to be built, along with the context in which they should be built.\n"
+      "x-intellij-html-description": "<p>represents items that need to be built, along with the context in which they should be built.</p>\n"
     },
     "ArtifactType": {
       "properties": {
@@ -186,7 +186,7 @@
       ],
       "additionalProperties": false,
       "description": "describes an artifact built with Bazel.",
-      "x-intellij-html-description": "describes an artifact built with Bazel.\n"
+      "x-intellij-html-description": "<p>describes an artifact built with Bazel.</p>\n"
     },
     "BuildConfig": {
       "anyOf": [
@@ -276,7 +276,7 @@
         }
       ],
       "description": "contains all the configuration for the build steps",
-      "x-intellij-html-description": "contains all the configuration for the build steps\n"
+      "x-intellij-html-description": "<p>contains all the configuration for the build steps</p>\n"
     },
     "BuildType": {
       "properties": {
@@ -297,7 +297,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.",
-      "x-intellij-html-description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.\n"
+      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the build step. Only one field should be populated.</p>\n"
     },
     "DateTimeTagger": {
       "properties": {
@@ -314,7 +314,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the DateTime tagger.",
-      "x-intellij-html-description": "contains the configuration for the DateTime tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the DateTime tagger.</p>\n"
     },
     "DeployConfig": {
       "anyOf": [
@@ -356,7 +356,7 @@
         }
       ],
       "description": "contains all the configuration needed by the deploy steps",
-      "x-intellij-html-description": "contains all the configuration needed by the deploy steps\n"
+      "x-intellij-html-description": "<p>contains all the configuration needed by the deploy steps</p>\n"
     },
     "DeployType": {
       "properties": {
@@ -377,7 +377,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.",
-      "x-intellij-html-description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.\n"
+      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.</p>\n"
     },
     "DockerArtifact": {
       "properties": {
@@ -410,7 +410,7 @@
       ],
       "additionalProperties": false,
       "description": "describes an artifact built from a Dockerfile, usually using `docker build`.",
-      "x-intellij-html-description": "describes an artifact built from a Dockerfile, usually using <code>docker build</code>.\n"
+      "x-intellij-html-description": "<p>describes an artifact built from a Dockerfile, usually using <code>docker build</code>.</p>\n"
     },
     "DockerConfig": {
       "properties": {
@@ -427,7 +427,7 @@
       ],
       "additionalProperties": false,
       "description": "contains information about the docker config.json to mount",
-      "x-intellij-html-description": "contains information about the docker config.json to mount\n"
+      "x-intellij-html-description": "<p>contains information about the docker config.json to mount</p>\n"
     },
     "EnvTemplateTagger": {
       "properties": {
@@ -440,11 +440,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the envTemplate tagger.",
-      "x-intellij-html-description": "contains the configuration for the envTemplate tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the envTemplate tagger.</p>\n"
     },
     "GitTagger": {
       "description": "contains the configuration for the git tagger.",
-      "x-intellij-html-description": "contains the configuration for the git tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the git tagger.</p>\n"
     },
     "GoogleCloudBuild": {
       "properties": {
@@ -481,11 +481,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a remote build on Google Cloud Build.",
-      "x-intellij-html-description": "contains the fields needed to do a remote build on Google Cloud Build.\n"
+      "x-intellij-html-description": "<p>contains the fields needed to do a remote build on Google Cloud Build.</p>\n"
     },
     "HelmConventionConfig": {
       "description": "represents image config in the syntax of image.repository and image.tag",
-      "x-intellij-html-description": "represents image config in the syntax of image.repository and image.tag\n"
+      "x-intellij-html-description": "<p>represents image config in the syntax of image.repository and image.tag</p>\n"
     },
     "HelmDeploy": {
       "properties": {
@@ -501,7 +501,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with helm",
-      "x-intellij-html-description": "contains the configuration needed for deploying with helm\n"
+      "x-intellij-html-description": "<p>contains the configuration needed for deploying with helm</p>\n"
     },
     "HelmFQNConfig": {
       "properties": {
@@ -514,7 +514,7 @@
       ],
       "additionalProperties": false,
       "description": "represents image config to use the FullyQualifiedImageName as param to set",
-      "x-intellij-html-description": "represents image config to use the FullyQualifiedImageName as param to set\n"
+      "x-intellij-html-description": "<p>represents image config to use the FullyQualifiedImageName as param to set</p>\n"
     },
     "HelmImageConfig": {
       "properties": {
@@ -565,12 +565,12 @@
         "appVersion": {
           "type": "string",
           "description": "set the appVersion on the chart to this version",
-          "x-intellij-html-description": "set the appVersion on the chart to this version\n"
+          "x-intellij-html-description": "<p>set the appVersion on the chart to this version</p>\n"
         },
         "version": {
           "type": "string",
           "description": "sets the version on the chart to this semver version.",
-          "x-intellij-html-description": "sets the version on the chart to this semver version.\n"
+          "x-intellij-html-description": "<p>sets the version on the chart to this semver version.</p>\n"
         }
       },
       "preferredOrder": [
@@ -579,7 +579,7 @@
       ],
       "additionalProperties": false,
       "description": "represents parameters for packaging helm chart.",
-      "x-intellij-html-description": "represents parameters for packaging helm chart.\n"
+      "x-intellij-html-description": "<p>represents parameters for packaging helm chart.</p>\n"
     },
     "HelmRelease": {
       "properties": {
@@ -665,7 +665,7 @@
         "project": {
           "type": "string",
           "description": "Only multi-module",
-          "x-intellij-html-description": "Only multi-module\n"
+          "x-intellij-html-description": "<p>Only multi-module</p>\n"
         }
       },
       "preferredOrder": [
@@ -678,7 +678,7 @@
         "module": {
           "type": "string",
           "description": "Only multi-module",
-          "x-intellij-html-description": "Only multi-module\n"
+          "x-intellij-html-description": "<p>Only multi-module</p>\n"
         },
         "profile": {
           "type": "string"
@@ -737,7 +737,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a on-cluster build using the kaniko image",
-      "x-intellij-html-description": "contains the fields needed to do a on-cluster build using the kaniko image\n"
+      "x-intellij-html-description": "<p>contains the fields needed to do a on-cluster build using the kaniko image</p>\n"
     },
     "KanikoBuildContext": {
       "properties": {
@@ -754,7 +754,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the different fields available to specify a kaniko build context",
-      "x-intellij-html-description": "contains the different fields available to specify a kaniko build context\n"
+      "x-intellij-html-description": "<p>contains the different fields available to specify a kaniko build context</p>\n"
     },
     "KanikoCache": {
       "properties": {
@@ -767,7 +767,7 @@
       ],
       "additionalProperties": false,
       "description": "contains fields related to kaniko caching",
-      "x-intellij-html-description": "contains fields related to kaniko caching\n"
+      "x-intellij-html-description": "<p>contains fields related to kaniko caching</p>\n"
     },
     "KubectlDeploy": {
       "properties": {
@@ -796,7 +796,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with `kubectl apply`",
-      "x-intellij-html-description": "contains the configuration needed for deploying with <code>kubectl apply</code>\n"
+      "x-intellij-html-description": "<p>contains the configuration needed for deploying with <code>kubectl apply</code></p>\n"
     },
     "KubectlFlags": {
       "properties": {
@@ -829,7 +829,7 @@
       ],
       "additionalProperties": false,
       "description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).",
-      "x-intellij-html-description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).\n"
+      "x-intellij-html-description": "<p>describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).</p>\n"
     },
     "KustomizeDeploy": {
       "properties": {
@@ -846,7 +846,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with kustomize.",
-      "x-intellij-html-description": "contains the configuration needed for deploying with kustomize.\n"
+      "x-intellij-html-description": "<p>contains the configuration needed for deploying with kustomize.</p>\n"
     },
     "LocalBuild": {
       "properties": {
@@ -869,11 +869,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository.",
-      "x-intellij-html-description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository.\n"
+      "x-intellij-html-description": "<p>contains the fields needed to do a build on the local docker daemon and optionally push to a repository.</p>\n"
     },
     "LocalDir": {
       "description": "represents the local directory kaniko build context",
-      "x-intellij-html-description": "represents the local directory kaniko build context\n"
+      "x-intellij-html-description": "<p>represents the local directory kaniko build context</p>\n"
     },
     "Profile": {
       "properties": {
@@ -898,11 +898,11 @@
       ],
       "additionalProperties": false,
       "description": "additional configuration that overrides default configuration when it is activated.",
-      "x-intellij-html-description": "additional configuration that overrides default configuration when it is activated.\n"
+      "x-intellij-html-description": "<p>additional configuration that overrides default configuration when it is activated.</p>\n"
     },
     "ShaTagger": {
       "description": "contains the configuration for the SHA tagger.",
-      "x-intellij-html-description": "contains the configuration for the SHA tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the SHA tagger.</p>\n"
     },
     "SkaffoldPipeline": {
       "properties": {
@@ -961,7 +961,7 @@
       ],
       "additionalProperties": false,
       "description": "contains all the configuration for the tagging step",
-      "x-intellij-html-description": "contains all the configuration for the tagging step\n"
+      "x-intellij-html-description": "<p>contains all the configuration for the tagging step</p>\n"
     },
     "TestCase": {
       "properties": {
@@ -982,7 +982,7 @@
       ],
       "additionalProperties": false,
       "description": "a struct containing all the specified test configuration for an image.",
-      "x-intellij-html-description": "a struct containing all the specified test configuration for an image.\n"
+      "x-intellij-html-description": "<p>a struct containing all the specified test configuration for an image.</p>\n"
     },
     "TestConfig": {
       "items": {
diff --git a/docs/content/en/schemas/v1beta4.json b/docs/content/en/schemas/v1beta4.json
index bf8c1c3018b..0ff16962b35 100755
--- a/docs/content/en/schemas/v1beta4.json
+++ b/docs/content/en/schemas/v1beta4.json
@@ -26,7 +26,7 @@
       ],
       "additionalProperties": false,
       "description": "defines criteria to auto-activate a profile.",
-      "x-intellij-html-description": "defines criteria to auto-activate a profile.\n"
+      "x-intellij-html-description": "<p>defines criteria to auto-activate a profile.</p>\n"
     },
     "Artifact": {
       "anyOf": [
@@ -163,7 +163,7 @@
         }
       ],
       "description": "represents items that need to be built, along with the context in which they should be built.",
-      "x-intellij-html-description": "represents items that need to be built, along with the context in which they should be built.\n"
+      "x-intellij-html-description": "<p>represents items that need to be built, along with the context in which they should be built.</p>\n"
     },
     "ArtifactType": {
       "properties": {
@@ -207,7 +207,7 @@
       ],
       "additionalProperties": false,
       "description": "describes an artifact built with Bazel.",
-      "x-intellij-html-description": "describes an artifact built with Bazel.\n"
+      "x-intellij-html-description": "<p>describes an artifact built with Bazel.</p>\n"
     },
     "BuildConfig": {
       "anyOf": [
@@ -297,7 +297,7 @@
         }
       ],
       "description": "contains all the configuration for the build steps",
-      "x-intellij-html-description": "contains all the configuration for the build steps\n"
+      "x-intellij-html-description": "<p>contains all the configuration for the build steps</p>\n"
     },
     "BuildType": {
       "properties": {
@@ -318,7 +318,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.",
-      "x-intellij-html-description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.\n"
+      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the build step. Only one field should be populated.</p>\n"
     },
     "DateTimeTagger": {
       "properties": {
@@ -335,7 +335,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the DateTime tagger.",
-      "x-intellij-html-description": "contains the configuration for the DateTime tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the DateTime tagger.</p>\n"
     },
     "DeployConfig": {
       "anyOf": [
@@ -377,7 +377,7 @@
         }
       ],
       "description": "contains all the configuration needed by the deploy steps",
-      "x-intellij-html-description": "contains all the configuration needed by the deploy steps\n"
+      "x-intellij-html-description": "<p>contains all the configuration needed by the deploy steps</p>\n"
     },
     "DeployType": {
       "properties": {
@@ -398,7 +398,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.",
-      "x-intellij-html-description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.\n"
+      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.</p>\n"
     },
     "DockerArtifact": {
       "properties": {
@@ -431,7 +431,7 @@
       ],
       "additionalProperties": false,
       "description": "describes an artifact built from a Dockerfile, usually using `docker build`.",
-      "x-intellij-html-description": "describes an artifact built from a Dockerfile, usually using <code>docker build</code>.\n"
+      "x-intellij-html-description": "<p>describes an artifact built from a Dockerfile, usually using <code>docker build</code>.</p>\n"
     },
     "DockerConfig": {
       "properties": {
@@ -448,7 +448,7 @@
       ],
       "additionalProperties": false,
       "description": "contains information about the docker config.json to mount",
-      "x-intellij-html-description": "contains information about the docker config.json to mount\n"
+      "x-intellij-html-description": "<p>contains information about the docker config.json to mount</p>\n"
     },
     "EnvTemplateTagger": {
       "properties": {
@@ -461,11 +461,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the envTemplate tagger.",
-      "x-intellij-html-description": "contains the configuration for the envTemplate tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the envTemplate tagger.</p>\n"
     },
     "GitTagger": {
       "description": "contains the configuration for the git tagger.",
-      "x-intellij-html-description": "contains the configuration for the git tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the git tagger.</p>\n"
     },
     "GoogleCloudBuild": {
       "properties": {
@@ -502,11 +502,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a remote build on Google Cloud Build.",
-      "x-intellij-html-description": "contains the fields needed to do a remote build on Google Cloud Build.\n"
+      "x-intellij-html-description": "<p>contains the fields needed to do a remote build on Google Cloud Build.</p>\n"
     },
     "HelmConventionConfig": {
       "description": "represents image config in the syntax of image.repository and image.tag",
-      "x-intellij-html-description": "represents image config in the syntax of image.repository and image.tag\n"
+      "x-intellij-html-description": "<p>represents image config in the syntax of image.repository and image.tag</p>\n"
     },
     "HelmDeploy": {
       "properties": {
@@ -522,7 +522,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with helm",
-      "x-intellij-html-description": "contains the configuration needed for deploying with helm\n"
+      "x-intellij-html-description": "<p>contains the configuration needed for deploying with helm</p>\n"
     },
     "HelmFQNConfig": {
       "properties": {
@@ -535,7 +535,7 @@
       ],
       "additionalProperties": false,
       "description": "represents image config to use the FullyQualifiedImageName as param to set",
-      "x-intellij-html-description": "represents image config to use the FullyQualifiedImageName as param to set\n"
+      "x-intellij-html-description": "<p>represents image config to use the FullyQualifiedImageName as param to set</p>\n"
     },
     "HelmImageConfig": {
       "properties": {
@@ -586,12 +586,12 @@
         "appVersion": {
           "type": "string",
           "description": "set the appVersion on the chart to this version",
-          "x-intellij-html-description": "set the appVersion on the chart to this version\n"
+          "x-intellij-html-description": "<p>set the appVersion on the chart to this version</p>\n"
         },
         "version": {
           "type": "string",
           "description": "sets the version on the chart to this semver version.",
-          "x-intellij-html-description": "sets the version on the chart to this semver version.\n"
+          "x-intellij-html-description": "<p>sets the version on the chart to this semver version.</p>\n"
         }
       },
       "preferredOrder": [
@@ -600,7 +600,7 @@
       ],
       "additionalProperties": false,
       "description": "represents parameters for packaging helm chart.",
-      "x-intellij-html-description": "represents parameters for packaging helm chart.\n"
+      "x-intellij-html-description": "<p>represents parameters for packaging helm chart.</p>\n"
     },
     "HelmRelease": {
       "properties": {
@@ -691,7 +691,7 @@
         "project": {
           "type": "string",
           "description": "Only multi-module",
-          "x-intellij-html-description": "Only multi-module\n"
+          "x-intellij-html-description": "<p>Only multi-module</p>\n"
         }
       },
       "preferredOrder": [
@@ -704,7 +704,7 @@
         "module": {
           "type": "string",
           "description": "Only multi-module",
-          "x-intellij-html-description": "Only multi-module\n"
+          "x-intellij-html-description": "<p>Only multi-module</p>\n"
         },
         "profile": {
           "type": "string"
@@ -763,7 +763,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a on-cluster build using the kaniko image",
-      "x-intellij-html-description": "contains the fields needed to do a on-cluster build using the kaniko image\n"
+      "x-intellij-html-description": "<p>contains the fields needed to do a on-cluster build using the kaniko image</p>\n"
     },
     "KanikoBuildContext": {
       "properties": {
@@ -780,7 +780,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the different fields available to specify a kaniko build context",
-      "x-intellij-html-description": "contains the different fields available to specify a kaniko build context\n"
+      "x-intellij-html-description": "<p>contains the different fields available to specify a kaniko build context</p>\n"
     },
     "KanikoCache": {
       "properties": {
@@ -793,7 +793,7 @@
       ],
       "additionalProperties": false,
       "description": "contains fields related to kaniko caching",
-      "x-intellij-html-description": "contains fields related to kaniko caching\n"
+      "x-intellij-html-description": "<p>contains fields related to kaniko caching</p>\n"
     },
     "KubectlDeploy": {
       "properties": {
@@ -822,7 +822,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with `kubectl apply`",
-      "x-intellij-html-description": "contains the configuration needed for deploying with <code>kubectl apply</code>\n"
+      "x-intellij-html-description": "<p>contains the configuration needed for deploying with <code>kubectl apply</code></p>\n"
     },
     "KubectlFlags": {
       "properties": {
@@ -855,7 +855,7 @@
       ],
       "additionalProperties": false,
       "description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).",
-      "x-intellij-html-description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).\n"
+      "x-intellij-html-description": "<p>describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).</p>\n"
     },
     "KustomizeDeploy": {
       "properties": {
@@ -872,7 +872,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with kustomize.",
-      "x-intellij-html-description": "contains the configuration needed for deploying with kustomize.\n"
+      "x-intellij-html-description": "<p>contains the configuration needed for deploying with kustomize.</p>\n"
     },
     "LocalBuild": {
       "properties": {
@@ -895,11 +895,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository.",
-      "x-intellij-html-description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository.\n"
+      "x-intellij-html-description": "<p>contains the fields needed to do a build on the local docker daemon and optionally push to a repository.</p>\n"
     },
     "LocalDir": {
       "description": "represents the local directory kaniko build context",
-      "x-intellij-html-description": "represents the local directory kaniko build context\n"
+      "x-intellij-html-description": "<p>represents the local directory kaniko build context</p>\n"
     },
     "Profile": {
       "properties": {
@@ -933,11 +933,11 @@
       ],
       "additionalProperties": false,
       "description": "additional configuration that overrides default configuration when it is activated.",
-      "x-intellij-html-description": "additional configuration that overrides default configuration when it is activated.\n"
+      "x-intellij-html-description": "<p>additional configuration that overrides default configuration when it is activated.</p>\n"
     },
     "ShaTagger": {
       "description": "contains the configuration for the SHA tagger.",
-      "x-intellij-html-description": "contains the configuration for the SHA tagger.\n"
+      "x-intellij-html-description": "<p>contains the configuration for the SHA tagger.</p>\n"
     },
     "SkaffoldPipeline": {
       "properties": {
@@ -996,7 +996,7 @@
       ],
       "additionalProperties": false,
       "description": "contains all the configuration for the tagging step",
-      "x-intellij-html-description": "contains all the configuration for the tagging step\n"
+      "x-intellij-html-description": "<p>contains all the configuration for the tagging step</p>\n"
     },
     "TestCase": {
       "properties": {
@@ -1017,7 +1017,7 @@
       ],
       "additionalProperties": false,
       "description": "a struct containing all the specified test configuration for an image.",
-      "x-intellij-html-description": "a struct containing all the specified test configuration for an image.\n"
+      "x-intellij-html-description": "<p>a struct containing all the specified test configuration for an image.</p>\n"
     },
     "TestConfig": {
       "items": {
diff --git a/docs/content/en/schemas/v1beta5.json b/docs/content/en/schemas/v1beta5.json
index 78acde2a4f1..6a6cb957b1c 100755
--- a/docs/content/en/schemas/v1beta5.json
+++ b/docs/content/en/schemas/v1beta5.json
@@ -12,7 +12,7 @@
         "command": {
           "type": "string",
           "description": "a Skaffold command for which the profile is auto-activated.",
-          "x-intellij-html-description": "a Skaffold command for which the profile is auto-activated.\n",
+          "x-intellij-html-description": "<p>a Skaffold command for which the profile is auto-activated.</p>\n",
           "examples": [
             "dev"
           ]
@@ -20,7 +20,7 @@
         "env": {
           "type": "string",
           "description": "a key=value pair. The profile is auto-activated if an Environment Variable `key` has value `value`.",
-          "x-intellij-html-description": "a key=value pair. The profile is auto-activated if an Environment Variable <code>key</code> has value <code>value</code>.\n",
+          "x-intellij-html-description": "<p>a key=value pair. The profile is auto-activated if an Environment Variable <code>key</code> has value <code>value</code>.</p>\n",
           "examples": [
             "ENV=production"
           ]
@@ -28,7 +28,7 @@
         "kubeContext": {
           "type": "string",
           "description": "a Kubernetes context for which the profile is auto-activated.",
-          "x-intellij-html-description": "a Kubernetes context for which the profile is auto-activated.\n",
+          "x-intellij-html-description": "<p>a Kubernetes context for which the profile is auto-activated.</p>\n",
           "examples": [
             "minikube"
           ]
@@ -41,7 +41,7 @@
       ],
       "additionalProperties": false,
       "description": "criteria by which a profile is auto-activated.",
-      "x-intellij-html-description": "criteria by which a profile is auto-activated.\n"
+      "x-intellij-html-description": "<p>criteria by which a profile is auto-activated.</p>\n"
     },
     "Artifact": {
       "required": [
@@ -53,13 +53,13 @@
             "context": {
               "type": "string",
               "description": "directory where the artifact's sources are to be found.",
-              "x-intellij-html-description": "directory where the artifact's sources are to be found.\n",
+              "x-intellij-html-description": "<p>directory where the artifact's sources are to be found.</p>\n",
               "default": "."
             },
             "image": {
               "type": "string",
               "description": "name of the image to be built.",
-              "x-intellij-html-description": "name of the image to be built.\n",
+              "x-intellij-html-description": "<p>name of the image to be built.</p>\n",
               "examples": [
                 "gcr.io/k8s-skaffold/example"
               ]
@@ -67,15 +67,15 @@
             "plugin": {
               "$ref": "#/definitions/BuilderPlugin",
               "description": "plugin used to build this artifact.",
-              "x-intellij-html-description": "plugin used to build this artifact.\n"
+              "x-intellij-html-description": "<p>plugin used to build this artifact.</p>\n"
             },
             "sync": {
               "additionalProperties": {
                 "type": "string"
               },
               "type": "object",
-              "description": "(alpha) lists local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
-              "x-intellij-html-description": "(alpha) lists local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.\n",
+              "description": "*alpha* local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
+              "x-intellij-html-description": "<p><em>alpha</em> local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.</p>\n",
               "default": "{}",
               "examples": [
                 "{\"*.py\": \".\", \"css/**/*.css\": \"app/css\"}"
@@ -95,18 +95,18 @@
             "context": {
               "type": "string",
               "description": "directory where the artifact's sources are to be found.",
-              "x-intellij-html-description": "directory where the artifact's sources are to be found.\n",
+              "x-intellij-html-description": "<p>directory where the artifact's sources are to be found.</p>\n",
               "default": "."
             },
             "docker": {
               "$ref": "#/definitions/DockerArtifact",
-              "description": "(beta) describes an artifact built from a Dockerfile.",
-              "x-intellij-html-description": "(beta) describes an artifact built from a Dockerfile.\n"
+              "description": "*beta* describes an artifact built from a Dockerfile.",
+              "x-intellij-html-description": "<p><em>beta</em> describes an artifact built from a Dockerfile.</p>\n"
             },
             "image": {
               "type": "string",
               "description": "name of the image to be built.",
-              "x-intellij-html-description": "name of the image to be built.\n",
+              "x-intellij-html-description": "<p>name of the image to be built.</p>\n",
               "examples": [
                 "gcr.io/k8s-skaffold/example"
               ]
@@ -114,15 +114,15 @@
             "plugin": {
               "$ref": "#/definitions/BuilderPlugin",
               "description": "plugin used to build this artifact.",
-              "x-intellij-html-description": "plugin used to build this artifact.\n"
+              "x-intellij-html-description": "<p>plugin used to build this artifact.</p>\n"
             },
             "sync": {
               "additionalProperties": {
                 "type": "string"
               },
               "type": "object",
-              "description": "(alpha) lists local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
-              "x-intellij-html-description": "(alpha) lists local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.\n",
+              "description": "*alpha* local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
+              "x-intellij-html-description": "<p><em>alpha</em> local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.</p>\n",
               "default": "{}",
               "examples": [
                 "{\"*.py\": \".\", \"css/**/*.css\": \"app/css\"}"
@@ -142,19 +142,19 @@
           "properties": {
             "bazel": {
               "$ref": "#/definitions/BazelArtifact",
-              "description": "(beta) requires bazel CLI to be installed and the sources to contain [Bazel](https://bazel.build/) configuration files.",
-              "x-intellij-html-description": "(beta) requires bazel CLI to be installed and the sources to contain <a href=\"https://bazel.build/\">Bazel</a> configuration files.\n"
+              "description": "*beta* requires bazel CLI to be installed and the sources to contain [Bazel](https://bazel.build/) configuration files.",
+              "x-intellij-html-description": "<p><em>beta</em> requires bazel CLI to be installed and the sources to contain <a href=\"https://bazel.build/\">Bazel</a> configuration files.</p>\n"
             },
             "context": {
               "type": "string",
               "description": "directory where the artifact's sources are to be found.",
-              "x-intellij-html-description": "directory where the artifact's sources are to be found.\n",
+              "x-intellij-html-description": "<p>directory where the artifact's sources are to be found.</p>\n",
               "default": "."
             },
             "image": {
               "type": "string",
               "description": "name of the image to be built.",
-              "x-intellij-html-description": "name of the image to be built.\n",
+              "x-intellij-html-description": "<p>name of the image to be built.</p>\n",
               "examples": [
                 "gcr.io/k8s-skaffold/example"
               ]
@@ -162,15 +162,15 @@
             "plugin": {
               "$ref": "#/definitions/BuilderPlugin",
               "description": "plugin used to build this artifact.",
-              "x-intellij-html-description": "plugin used to build this artifact.\n"
+              "x-intellij-html-description": "<p>plugin used to build this artifact.</p>\n"
             },
             "sync": {
               "additionalProperties": {
                 "type": "string"
               },
               "type": "object",
-              "description": "(alpha) lists local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
-              "x-intellij-html-description": "(alpha) lists local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.\n",
+              "description": "*alpha* local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
+              "x-intellij-html-description": "<p><em>alpha</em> local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.</p>\n",
               "default": "{}",
               "examples": [
                 "{\"*.py\": \".\", \"css/**/*.css\": \"app/css\"}"
@@ -191,34 +191,34 @@
             "context": {
               "type": "string",
               "description": "directory where the artifact's sources are to be found.",
-              "x-intellij-html-description": "directory where the artifact's sources are to be found.\n",
+              "x-intellij-html-description": "<p>directory where the artifact's sources are to be found.</p>\n",
               "default": "."
             },
             "image": {
               "type": "string",
               "description": "name of the image to be built.",
-              "x-intellij-html-description": "name of the image to be built.\n",
+              "x-intellij-html-description": "<p>name of the image to be built.</p>\n",
               "examples": [
                 "gcr.io/k8s-skaffold/example"
               ]
             },
             "jibMaven": {
               "$ref": "#/definitions/JibMavenArtifact",
-              "description": "(alpha) builds images using the [Jib plugin for Maven](https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin).",
-              "x-intellij-html-description": "(alpha) builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin\">Jib plugin for Maven</a>.\n"
+              "description": "*alpha* builds images using the [Jib plugin for Maven](https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin).",
+              "x-intellij-html-description": "<p><em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin\">Jib plugin for Maven</a>.</p>\n"
             },
             "plugin": {
               "$ref": "#/definitions/BuilderPlugin",
               "description": "plugin used to build this artifact.",
-              "x-intellij-html-description": "plugin used to build this artifact.\n"
+              "x-intellij-html-description": "<p>plugin used to build this artifact.</p>\n"
             },
             "sync": {
               "additionalProperties": {
                 "type": "string"
               },
               "type": "object",
-              "description": "(alpha) lists local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
-              "x-intellij-html-description": "(alpha) lists local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.\n",
+              "description": "*alpha* local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
+              "x-intellij-html-description": "<p><em>alpha</em> local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.</p>\n",
               "default": "{}",
               "examples": [
                 "{\"*.py\": \".\", \"css/**/*.css\": \"app/css\"}"
@@ -239,34 +239,34 @@
             "context": {
               "type": "string",
               "description": "directory where the artifact's sources are to be found.",
-              "x-intellij-html-description": "directory where the artifact's sources are to be found.\n",
+              "x-intellij-html-description": "<p>directory where the artifact's sources are to be found.</p>\n",
               "default": "."
             },
             "image": {
               "type": "string",
               "description": "name of the image to be built.",
-              "x-intellij-html-description": "name of the image to be built.\n",
+              "x-intellij-html-description": "<p>name of the image to be built.</p>\n",
               "examples": [
                 "gcr.io/k8s-skaffold/example"
               ]
             },
             "jibGradle": {
               "$ref": "#/definitions/JibGradleArtifact",
-              "description": "(alpha) builds images using the [Jib plugin for Gradle](https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin).",
-              "x-intellij-html-description": "(alpha) builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin\">Jib plugin for Gradle</a>.\n"
+              "description": "*alpha* builds images using the [Jib plugin for Gradle](https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin).",
+              "x-intellij-html-description": "<p><em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin\">Jib plugin for Gradle</a>.</p>\n"
             },
             "plugin": {
               "$ref": "#/definitions/BuilderPlugin",
               "description": "plugin used to build this artifact.",
-              "x-intellij-html-description": "plugin used to build this artifact.\n"
+              "x-intellij-html-description": "<p>plugin used to build this artifact.</p>\n"
             },
             "sync": {
               "additionalProperties": {
                 "type": "string"
               },
               "type": "object",
-              "description": "(alpha) lists local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
-              "x-intellij-html-description": "(alpha) lists local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.\n",
+              "description": "*alpha* local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
+              "x-intellij-html-description": "<p><em>alpha</em> local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.</p>\n",
               "default": "{}",
               "examples": [
                 "{\"*.py\": \".\", \"css/**/*.css\": \"app/css\"}"
@@ -284,29 +284,29 @@
         }
       ],
       "description": "items that need to be built, along with the context in which they should be built.",
-      "x-intellij-html-description": "items that need to be built, along with the context in which they should be built.\n"
+      "x-intellij-html-description": "<p>items that need to be built, along with the context in which they should be built.</p>\n"
     },
     "ArtifactType": {
       "properties": {
         "bazel": {
           "$ref": "#/definitions/BazelArtifact",
-          "description": "(beta) requires bazel CLI to be installed and the sources to contain [Bazel](https://bazel.build/) configuration files.",
-          "x-intellij-html-description": "(beta) requires bazel CLI to be installed and the sources to contain <a href=\"https://bazel.build/\">Bazel</a> configuration files.\n"
+          "description": "*beta* requires bazel CLI to be installed and the sources to contain [Bazel](https://bazel.build/) configuration files.",
+          "x-intellij-html-description": "<p><em>beta</em> requires bazel CLI to be installed and the sources to contain <a href=\"https://bazel.build/\">Bazel</a> configuration files.</p>\n"
         },
         "docker": {
           "$ref": "#/definitions/DockerArtifact",
-          "description": "(beta) describes an artifact built from a Dockerfile.",
-          "x-intellij-html-description": "(beta) describes an artifact built from a Dockerfile.\n"
+          "description": "*beta* describes an artifact built from a Dockerfile.",
+          "x-intellij-html-description": "<p><em>beta</em> describes an artifact built from a Dockerfile.</p>\n"
         },
         "jibGradle": {
           "$ref": "#/definitions/JibGradleArtifact",
-          "description": "(alpha) builds images using the [Jib plugin for Gradle](https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin).",
-          "x-intellij-html-description": "(alpha) builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin\">Jib plugin for Gradle</a>.\n"
+          "description": "*alpha* builds images using the [Jib plugin for Gradle](https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin).",
+          "x-intellij-html-description": "<p><em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin\">Jib plugin for Gradle</a>.</p>\n"
         },
         "jibMaven": {
           "$ref": "#/definitions/JibMavenArtifact",
-          "description": "(alpha) builds images using the [Jib plugin for Maven](https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin).",
-          "x-intellij-html-description": "(alpha) builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin\">Jib plugin for Maven</a>.\n"
+          "description": "*alpha* builds images using the [Jib plugin for Maven](https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin).",
+          "x-intellij-html-description": "<p><em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin\">Jib plugin for Maven</a>.</p>\n"
         }
       },
       "preferredOrder": [
@@ -328,7 +328,7 @@
           },
           "type": "array",
           "description": "additional args to pass to `bazel build`.",
-          "x-intellij-html-description": "additional args to pass to <code>bazel build</code>.\n",
+          "x-intellij-html-description": "<p>additional args to pass to <code>bazel build</code>.</p>\n",
           "default": "[]",
           "examples": [
             "[\"-flag\", \"--otherflag\"]"
@@ -337,7 +337,7 @@
         "target": {
           "type": "string",
           "description": "`bazel build` target to run.",
-          "x-intellij-html-description": "<code>bazel build</code> target to run.\n",
+          "x-intellij-html-description": "<p><code>bazel build</code> target to run.</p>\n",
           "examples": [
             "//:skaffold_example.tar"
           ]
@@ -348,8 +348,8 @@
         "args"
       ],
       "additionalProperties": false,
-      "description": "(beta) describes an artifact built with [Bazel](https://bazel.build/).",
-      "x-intellij-html-description": "(beta) describes an artifact built with <a href=\"https://bazel.build/\">Bazel</a>.\n"
+      "description": "*beta* describes an artifact built with [Bazel](https://bazel.build/).",
+      "x-intellij-html-description": "<p><em>beta</em> describes an artifact built with <a href=\"https://bazel.build/\">Bazel</a>.</p>\n"
     },
     "BuildConfig": {
       "anyOf": [
@@ -361,17 +361,17 @@
               },
               "type": "array",
               "description": "the images you're going to be building.",
-              "x-intellij-html-description": "the images you're going to be building.\n"
+              "x-intellij-html-description": "<p>the images you're going to be building.</p>\n"
             },
             "executionEnvironment": {
               "$ref": "#/definitions/ExecutionEnvironment",
               "description": "environment in which the build should run. Possible values: googleCloudBuild.",
-              "x-intellij-html-description": "environment in which the build should run. Possible values: googleCloudBuild.\n"
+              "x-intellij-html-description": "<p>environment in which the build should run. Possible values: googleCloudBuild.</p>\n"
             },
             "tagPolicy": {
               "$ref": "#/definitions/TagPolicy",
-              "description": "(beta) determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to `gitCommit: {}`.",
-              "x-intellij-html-description": "(beta) determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>.\n"
+              "description": "*beta* determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to `gitCommit: {}`.",
+              "x-intellij-html-description": "<p><em>beta</em> determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>.</p>\n"
             }
           },
           "preferredOrder": [
@@ -389,22 +389,22 @@
               },
               "type": "array",
               "description": "the images you're going to be building.",
-              "x-intellij-html-description": "the images you're going to be building.\n"
+              "x-intellij-html-description": "<p>the images you're going to be building.</p>\n"
             },
             "executionEnvironment": {
               "$ref": "#/definitions/ExecutionEnvironment",
               "description": "environment in which the build should run. Possible values: googleCloudBuild.",
-              "x-intellij-html-description": "environment in which the build should run. Possible values: googleCloudBuild.\n"
+              "x-intellij-html-description": "<p>environment in which the build should run. Possible values: googleCloudBuild.</p>\n"
             },
             "local": {
               "$ref": "#/definitions/LocalBuild",
-              "description": "(beta) describes how to do a build on the local docker daemon and optionally push to a repository.",
-              "x-intellij-html-description": "(beta) describes how to do a build on the local docker daemon and optionally push to a repository.\n"
+              "description": "*beta* describes how to do a build on the local docker daemon and optionally push to a repository.",
+              "x-intellij-html-description": "<p><em>beta</em> describes how to do a build on the local docker daemon and optionally push to a repository.</p>\n"
             },
             "tagPolicy": {
               "$ref": "#/definitions/TagPolicy",
-              "description": "(beta) determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to `gitCommit: {}`.",
-              "x-intellij-html-description": "(beta) determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>.\n"
+              "description": "*beta* determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to `gitCommit: {}`.",
+              "x-intellij-html-description": "<p><em>beta</em> determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>.</p>\n"
             }
           },
           "preferredOrder": [
@@ -423,22 +423,22 @@
               },
               "type": "array",
               "description": "the images you're going to be building.",
-              "x-intellij-html-description": "the images you're going to be building.\n"
+              "x-intellij-html-description": "<p>the images you're going to be building.</p>\n"
             },
             "executionEnvironment": {
               "$ref": "#/definitions/ExecutionEnvironment",
               "description": "environment in which the build should run. Possible values: googleCloudBuild.",
-              "x-intellij-html-description": "environment in which the build should run. Possible values: googleCloudBuild.\n"
+              "x-intellij-html-description": "<p>environment in which the build should run. Possible values: googleCloudBuild.</p>\n"
             },
             "googleCloudBuild": {
               "$ref": "#/definitions/GoogleCloudBuild",
-              "description": "(beta) describes how to do a remote build on [Google Cloud Build](https://cloud.google.com/cloud-build/).",
-              "x-intellij-html-description": "(beta) describes how to do a remote build on <a href=\"https://cloud.google.com/cloud-build/\">Google Cloud Build</a>.\n"
+              "description": "*beta* describes how to do a remote build on [Google Cloud Build](https://cloud.google.com/cloud-build/).",
+              "x-intellij-html-description": "<p><em>beta</em> describes how to do a remote build on <a href=\"https://cloud.google.com/cloud-build/\">Google Cloud Build</a>.</p>\n"
             },
             "tagPolicy": {
               "$ref": "#/definitions/TagPolicy",
-              "description": "(beta) determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to `gitCommit: {}`.",
-              "x-intellij-html-description": "(beta) determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>.\n"
+              "description": "*beta* determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to `gitCommit: {}`.",
+              "x-intellij-html-description": "<p><em>beta</em> determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>.</p>\n"
             }
           },
           "preferredOrder": [
@@ -457,22 +457,22 @@
               },
               "type": "array",
               "description": "the images you're going to be building.",
-              "x-intellij-html-description": "the images you're going to be building.\n"
+              "x-intellij-html-description": "<p>the images you're going to be building.</p>\n"
             },
             "executionEnvironment": {
               "$ref": "#/definitions/ExecutionEnvironment",
               "description": "environment in which the build should run. Possible values: googleCloudBuild.",
-              "x-intellij-html-description": "environment in which the build should run. Possible values: googleCloudBuild.\n"
+              "x-intellij-html-description": "<p>environment in which the build should run. Possible values: googleCloudBuild.</p>\n"
             },
             "kaniko": {
               "$ref": "#/definitions/KanikoBuild",
-              "description": "(beta) describes how to do an on-cluster build using [Kaniko](https://github.com/GoogleContainerTools/kaniko).",
-              "x-intellij-html-description": "(beta) describes how to do an on-cluster build using <a href=\"https://github.com/GoogleContainerTools/kaniko\">Kaniko</a>.\n"
+              "description": "*beta* describes how to do an on-cluster build using [Kaniko](https://github.com/GoogleContainerTools/kaniko).",
+              "x-intellij-html-description": "<p><em>beta</em> describes how to do an on-cluster build using <a href=\"https://github.com/GoogleContainerTools/kaniko\">Kaniko</a>.</p>\n"
             },
             "tagPolicy": {
               "$ref": "#/definitions/TagPolicy",
-              "description": "(beta) determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to `gitCommit: {}`.",
-              "x-intellij-html-description": "(beta) determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>.\n"
+              "description": "*beta* determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to `gitCommit: {}`.",
+              "x-intellij-html-description": "<p><em>beta</em> determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>.</p>\n"
             }
           },
           "preferredOrder": [
@@ -485,24 +485,24 @@
         }
       ],
       "description": "contains all the configuration for the build steps.",
-      "x-intellij-html-description": "contains all the configuration for the build steps.\n"
+      "x-intellij-html-description": "<p>contains all the configuration for the build steps.</p>\n"
     },
     "BuildType": {
       "properties": {
         "googleCloudBuild": {
           "$ref": "#/definitions/GoogleCloudBuild",
-          "description": "(beta) describes how to do a remote build on [Google Cloud Build](https://cloud.google.com/cloud-build/).",
-          "x-intellij-html-description": "(beta) describes how to do a remote build on <a href=\"https://cloud.google.com/cloud-build/\">Google Cloud Build</a>.\n"
+          "description": "*beta* describes how to do a remote build on [Google Cloud Build](https://cloud.google.com/cloud-build/).",
+          "x-intellij-html-description": "<p><em>beta</em> describes how to do a remote build on <a href=\"https://cloud.google.com/cloud-build/\">Google Cloud Build</a>.</p>\n"
         },
         "kaniko": {
           "$ref": "#/definitions/KanikoBuild",
-          "description": "(beta) describes how to do an on-cluster build using [Kaniko](https://github.com/GoogleContainerTools/kaniko).",
-          "x-intellij-html-description": "(beta) describes how to do an on-cluster build using <a href=\"https://github.com/GoogleContainerTools/kaniko\">Kaniko</a>.\n"
+          "description": "*beta* describes how to do an on-cluster build using [Kaniko](https://github.com/GoogleContainerTools/kaniko).",
+          "x-intellij-html-description": "<p><em>beta</em> describes how to do an on-cluster build using <a href=\"https://github.com/GoogleContainerTools/kaniko\">Kaniko</a>.</p>\n"
         },
         "local": {
           "$ref": "#/definitions/LocalBuild",
-          "description": "(beta) describes how to do a build on the local docker daemon and optionally push to a repository.",
-          "x-intellij-html-description": "(beta) describes how to do a build on the local docker daemon and optionally push to a repository.\n"
+          "description": "*beta* describes how to do a build on the local docker daemon and optionally push to a repository.",
+          "x-intellij-html-description": "<p><em>beta</em> describes how to do a build on the local docker daemon and optionally push to a repository.</p>\n"
         }
       },
       "preferredOrder": [
@@ -512,20 +512,20 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.",
-      "x-intellij-html-description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.\n"
+      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the build step. Only one field should be populated.</p>\n"
     },
     "BuilderPlugin": {
       "properties": {
         "name": {
           "type": "string",
           "description": "name of the build plugin.",
-          "x-intellij-html-description": "name of the build plugin.\n"
+          "x-intellij-html-description": "<p>name of the build plugin.</p>\n"
         },
         "properties": {
           "additionalProperties": {},
           "type": "object",
           "description": "key-value pairs passed to the plugin.",
-          "x-intellij-html-description": "key-value pairs passed to the plugin.\n",
+          "x-intellij-html-description": "<p>key-value pairs passed to the plugin.</p>\n",
           "default": "{}"
         }
       },
@@ -535,20 +535,20 @@
       ],
       "additionalProperties": false,
       "description": "contains all fields necessary for specifying a build plugin.",
-      "x-intellij-html-description": "contains all fields necessary for specifying a build plugin.\n"
+      "x-intellij-html-description": "<p>contains all fields necessary for specifying a build plugin.</p>\n"
     },
     "DateTimeTagger": {
       "properties": {
         "format": {
           "type": "string",
           "description": "formats the date and time. See [#Time.Format](https://golang.org/pkg/time/#Time.Format).",
-          "x-intellij-html-description": "formats the date and time. See <a href=\"https://golang.org/pkg/time/#Time.Format\">#Time.Format</a>.\n",
+          "x-intellij-html-description": "<p>formats the date and time. See <a href=\"https://golang.org/pkg/time/#Time.Format\">#Time.Format</a>.</p>\n",
           "default": "2006-01-02_15-04-05.999_MST"
         },
         "timezone": {
           "type": "string",
           "description": "sets the timezone for the date and time. See [Time.LoadLocation](https://golang.org/pkg/time/#Time.LoadLocation). Defaults to the local timezone.",
-          "x-intellij-html-description": "sets the timezone for the date and time. See <a href=\"https://golang.org/pkg/time/#Time.LoadLocation\">Time.LoadLocation</a>. Defaults to the local timezone.\n"
+          "x-intellij-html-description": "<p>sets the timezone for the date and time. See <a href=\"https://golang.org/pkg/time/#Time.LoadLocation\">Time.LoadLocation</a>. Defaults to the local timezone.</p>\n"
         }
       },
       "preferredOrder": [
@@ -556,8 +556,8 @@
         "timezone"
       ],
       "additionalProperties": false,
-      "description": "(beta) tags images with the build timestamp.",
-      "x-intellij-html-description": "(beta) tags images with the build timestamp.\n"
+      "description": "*beta* tags images with the build timestamp.",
+      "x-intellij-html-description": "<p><em>beta</em> tags images with the build timestamp.</p>\n"
     },
     "DeployConfig": {
       "anyOf": [
@@ -568,8 +568,8 @@
           "properties": {
             "helm": {
               "$ref": "#/definitions/HelmDeploy",
-              "description": "(beta) uses the `helm` CLI to apply the charts to the cluster.",
-              "x-intellij-html-description": "(beta) uses the <code>helm</code> CLI to apply the charts to the cluster.\n"
+              "description": "*beta* uses the `helm` CLI to apply the charts to the cluster.",
+              "x-intellij-html-description": "<p><em>beta</em> uses the <code>helm</code> CLI to apply the charts to the cluster.</p>\n"
             }
           },
           "preferredOrder": [
@@ -581,8 +581,8 @@
           "properties": {
             "kubectl": {
               "$ref": "#/definitions/KubectlDeploy",
-              "description": "(beta) uses a client side `kubectl apply` to deploy manifests. You'll need a `kubectl` CLI version installed that's compatible with your cluster.",
-              "x-intellij-html-description": "(beta) uses a client side <code>kubectl apply</code> to deploy manifests. You'll need a <code>kubectl</code> CLI version installed that's compatible with your cluster.\n"
+              "description": "*beta* uses a client side `kubectl apply` to deploy manifests. You'll need a `kubectl` CLI version installed that's compatible with your cluster.",
+              "x-intellij-html-description": "<p><em>beta</em> uses a client side <code>kubectl apply</code> to deploy manifests. You'll need a <code>kubectl</code> CLI version installed that's compatible with your cluster.</p>\n"
             }
           },
           "preferredOrder": [
@@ -594,8 +594,8 @@
           "properties": {
             "kustomize": {
               "$ref": "#/definitions/KustomizeDeploy",
-              "description": "(beta) uses the `kustomize` CLI to \"patch\" a deployment for a target environment.",
-              "x-intellij-html-description": "(beta) uses the <code>kustomize</code> CLI to &quot;patch&quot; a deployment for a target environment.\n"
+              "description": "*beta* uses the `kustomize` CLI to \"patch\" a deployment for a target environment.",
+              "x-intellij-html-description": "<p><em>beta</em> uses the <code>kustomize</code> CLI to &quot;patch&quot; a deployment for a target environment.</p>\n"
             }
           },
           "preferredOrder": [
@@ -605,24 +605,24 @@
         }
       ],
       "description": "contains all the configuration needed by the deploy steps.",
-      "x-intellij-html-description": "contains all the configuration needed by the deploy steps.\n"
+      "x-intellij-html-description": "<p>contains all the configuration needed by the deploy steps.</p>\n"
     },
     "DeployType": {
       "properties": {
         "helm": {
           "$ref": "#/definitions/HelmDeploy",
-          "description": "(beta) uses the `helm` CLI to apply the charts to the cluster.",
-          "x-intellij-html-description": "(beta) uses the <code>helm</code> CLI to apply the charts to the cluster.\n"
+          "description": "*beta* uses the `helm` CLI to apply the charts to the cluster.",
+          "x-intellij-html-description": "<p><em>beta</em> uses the <code>helm</code> CLI to apply the charts to the cluster.</p>\n"
         },
         "kubectl": {
           "$ref": "#/definitions/KubectlDeploy",
-          "description": "(beta) uses a client side `kubectl apply` to deploy manifests. You'll need a `kubectl` CLI version installed that's compatible with your cluster.",
-          "x-intellij-html-description": "(beta) uses a client side <code>kubectl apply</code> to deploy manifests. You'll need a <code>kubectl</code> CLI version installed that's compatible with your cluster.\n"
+          "description": "*beta* uses a client side `kubectl apply` to deploy manifests. You'll need a `kubectl` CLI version installed that's compatible with your cluster.",
+          "x-intellij-html-description": "<p><em>beta</em> uses a client side <code>kubectl apply</code> to deploy manifests. You'll need a <code>kubectl</code> CLI version installed that's compatible with your cluster.</p>\n"
         },
         "kustomize": {
           "$ref": "#/definitions/KustomizeDeploy",
-          "description": "(beta) uses the `kustomize` CLI to \"patch\" a deployment for a target environment.",
-          "x-intellij-html-description": "(beta) uses the <code>kustomize</code> CLI to &quot;patch&quot; a deployment for a target environment.\n"
+          "description": "*beta* uses the `kustomize` CLI to \"patch\" a deployment for a target environment.",
+          "x-intellij-html-description": "<p><em>beta</em> uses the <code>kustomize</code> CLI to &quot;patch&quot; a deployment for a target environment.</p>\n"
         }
       },
       "preferredOrder": [
@@ -632,7 +632,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.",
-      "x-intellij-html-description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.\n"
+      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.</p>\n"
     },
     "DockerArtifact": {
       "properties": {
@@ -642,7 +642,7 @@
           },
           "type": "object",
           "description": "arguments passed to the docker build.",
-          "x-intellij-html-description": "arguments passed to the docker build.\n",
+          "x-intellij-html-description": "<p>arguments passed to the docker build.</p>\n",
           "default": "{}",
           "examples": [
             "{\"key1\": \"value1\", \"key2\": \"value2\"}"
@@ -654,7 +654,7 @@
           },
           "type": "array",
           "description": "the Docker images to consider as cache sources.",
-          "x-intellij-html-description": "the Docker images to consider as cache sources.\n",
+          "x-intellij-html-description": "<p>the Docker images to consider as cache sources.</p>\n",
           "default": "[]",
           "examples": [
             "[\"golang:1.10.1-alpine3.7\", \"alpine:3.7\"]"
@@ -663,13 +663,13 @@
         "dockerfile": {
           "type": "string",
           "description": "locates the Dockerfile relative to workspace.",
-          "x-intellij-html-description": "locates the Dockerfile relative to workspace.\n",
+          "x-intellij-html-description": "<p>locates the Dockerfile relative to workspace.</p>\n",
           "default": "Dockerfile"
         },
         "target": {
           "type": "string",
           "description": "Dockerfile target name to build.",
-          "x-intellij-html-description": "Dockerfile target name to build.\n"
+          "x-intellij-html-description": "<p>Dockerfile target name to build.</p>\n"
         }
       },
       "preferredOrder": [
@@ -679,20 +679,20 @@
         "cacheFrom"
       ],
       "additionalProperties": false,
-      "description": "(beta) describes an artifact built from a Dockerfile, usually using `docker build`.",
-      "x-intellij-html-description": "(beta) describes an artifact built from a Dockerfile, usually using <code>docker build</code>.\n"
+      "description": "*beta* describes an artifact built from a Dockerfile, usually using `docker build`.",
+      "x-intellij-html-description": "<p><em>beta</em> describes an artifact built from a Dockerfile, usually using <code>docker build</code>.</p>\n"
     },
     "DockerConfig": {
       "properties": {
         "path": {
           "type": "string",
           "description": "path to the docker `config.json`.",
-          "x-intellij-html-description": "path to the docker <code>config.json</code>.\n"
+          "x-intellij-html-description": "<p>path to the docker <code>config.json</code>.</p>\n"
         },
         "secretName": {
           "type": "string",
           "description": "Kubernetes secret that will hold the Docker configuration.",
-          "x-intellij-html-description": "Kubernetes secret that will hold the Docker configuration.\n"
+          "x-intellij-html-description": "<p>Kubernetes secret that will hold the Docker configuration.</p>\n"
         }
       },
       "preferredOrder": [
@@ -701,7 +701,7 @@
       ],
       "additionalProperties": false,
       "description": "contains information about the docker `config.json` to mount.",
-      "x-intellij-html-description": "contains information about the docker <code>config.json</code> to mount.\n"
+      "x-intellij-html-description": "<p>contains information about the docker <code>config.json</code> to mount.</p>\n"
     },
     "EnvTemplateTagger": {
       "required": [
@@ -711,7 +711,7 @@
         "template": {
           "type": "string",
           "description": "used to produce the image name and tag. See golang [text/template](https://golang.org/pkg/text/template/). The template is executed against the current environment, with those variables injected:   IMAGE_NAME   |  Name of the image being built, as supplied in the artifacts section.",
-          "x-intellij-html-description": "used to produce the image name and tag. See golang <a href=\"https://golang.org/pkg/text/template/\">text/template</a>. The template is executed against the current environment, with those variables injected:   IMAGE_NAME   |  Name of the image being built, as supplied in the artifacts section.\n",
+          "x-intellij-html-description": "<p>used to produce the image name and tag. See golang <a href=\"https://golang.org/pkg/text/template/\">text/template</a>. The template is executed against the current environment, with those variables injected:   IMAGE_NAME   |  Name of the image being built, as supplied in the artifacts section.</p>\n",
           "examples": [
             "{{.RELEASE}}-{{.IMAGE_NAME}}"
           ]
@@ -721,8 +721,8 @@
         "template"
       ],
       "additionalProperties": false,
-      "description": "(beta) tags images with a configurable template string.",
-      "x-intellij-html-description": "(beta) tags images with a configurable template string.\n"
+      "description": "*beta* tags images with a configurable template string.",
+      "x-intellij-html-description": "<p><em>beta</em> tags images with a configurable template string.</p>\n"
     },
     "ExecEnvironment": {
       "type": "string"
@@ -732,13 +732,13 @@
         "name": {
           "$ref": "#/definitions/ExecEnvironment",
           "description": "name of the environment.",
-          "x-intellij-html-description": "name of the environment.\n"
+          "x-intellij-html-description": "<p>name of the environment.</p>\n"
         },
         "properties": {
           "additionalProperties": {},
           "type": "object",
           "description": "key-value pairs passed to the environment.",
-          "x-intellij-html-description": "key-value pairs passed to the environment.\n",
+          "x-intellij-html-description": "<p>key-value pairs passed to the environment.</p>\n",
           "default": "{}"
         }
       },
@@ -748,51 +748,51 @@
       ],
       "additionalProperties": false,
       "description": "environment in which the build should run (ex. local or in-cluster, etc.).",
-      "x-intellij-html-description": "environment in which the build should run (ex. local or in-cluster, etc.).\n"
+      "x-intellij-html-description": "<p>environment in which the build should run (ex. local or in-cluster, etc.).</p>\n"
     },
     "GitTagger": {
-      "description": "(beta) tags images with the git tag or commit of the artifact's workspace.",
-      "x-intellij-html-description": "(beta) tags images with the git tag or commit of the artifact's workspace.\n"
+      "description": "*beta* tags images with the git tag or commit of the artifact's workspace.",
+      "x-intellij-html-description": "<p><em>beta</em> tags images with the git tag or commit of the artifact's workspace.</p>\n"
     },
     "GoogleCloudBuild": {
       "properties": {
         "diskSizeGb": {
           "type": "number",
           "description": "disk size of the VM that runs the build. See [Cloud Build Reference](https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#buildoptions).",
-          "x-intellij-html-description": "disk size of the VM that runs the build. See <a href=\"https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#buildoptions\">Cloud Build Reference</a>.\n"
+          "x-intellij-html-description": "<p>disk size of the VM that runs the build. See <a href=\"https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#buildoptions\">Cloud Build Reference</a>.</p>\n"
         },
         "dockerImage": {
           "type": "string",
           "description": "image that runs a Docker build. See [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders).",
-          "x-intellij-html-description": "image that runs a Docker build. See <a href=\"https://cloud.google.com/cloud-build/docs/cloud-builders\">Cloud Builders</a>.\n",
+          "x-intellij-html-description": "<p>image that runs a Docker build. See <a href=\"https://cloud.google.com/cloud-build/docs/cloud-builders\">Cloud Builders</a>.</p>\n",
           "default": "gcr.io/cloud-builders/docker"
         },
         "gradleImage": {
           "type": "string",
           "description": "image that runs a Gradle build. See [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders).",
-          "x-intellij-html-description": "image that runs a Gradle build. See <a href=\"https://cloud.google.com/cloud-build/docs/cloud-builders\">Cloud Builders</a>.\n",
+          "x-intellij-html-description": "<p>image that runs a Gradle build. See <a href=\"https://cloud.google.com/cloud-build/docs/cloud-builders\">Cloud Builders</a>.</p>\n",
           "default": "gcr.io/cloud-builders/gradle"
         },
         "machineType": {
           "type": "string",
           "description": "type of the VM that runs the build. See [Cloud Build Reference](https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#buildoptions).",
-          "x-intellij-html-description": "type of the VM that runs the build. See <a href=\"https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#buildoptions\">Cloud Build Reference</a>.\n"
+          "x-intellij-html-description": "<p>type of the VM that runs the build. See <a href=\"https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#buildoptions\">Cloud Build Reference</a>.</p>\n"
         },
         "mavenImage": {
           "type": "string",
           "description": "image that runs a Maven build. See [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders).",
-          "x-intellij-html-description": "image that runs a Maven build. See <a href=\"https://cloud.google.com/cloud-build/docs/cloud-builders\">Cloud Builders</a>.\n",
+          "x-intellij-html-description": "<p>image that runs a Maven build. See <a href=\"https://cloud.google.com/cloud-build/docs/cloud-builders\">Cloud Builders</a>.</p>\n",
           "default": "gcr.io/cloud-builders/mvn"
         },
         "projectId": {
           "type": "string",
           "description": "ID of your Cloud Platform Project. If it is not provided, Skaffold will guess it from the image name. For example, given the artifact image name `gcr.io/myproject/image`, Skaffold will use the `myproject` GCP project.",
-          "x-intellij-html-description": "ID of your Cloud Platform Project. If it is not provided, Skaffold will guess it from the image name. For example, given the artifact image name <code>gcr.io/myproject/image</code>, Skaffold will use the <code>myproject</code> GCP project.\n"
+          "x-intellij-html-description": "<p>ID of your Cloud Platform Project. If it is not provided, Skaffold will guess it from the image name. For example, given the artifact image name <code>gcr.io/myproject/image</code>, Skaffold will use the <code>myproject</code> GCP project.</p>\n"
         },
         "timeout": {
           "type": "string",
           "description": "amount of time (in seconds) that this build should be allowed to run. See [Cloud Build Reference](https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#resource-build).",
-          "x-intellij-html-description": "amount of time (in seconds) that this build should be allowed to run. See <a href=\"https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#resource-build\">Cloud Build Reference</a>.\n"
+          "x-intellij-html-description": "<p>amount of time (in seconds) that this build should be allowed to run. See <a href=\"https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#resource-build\">Cloud Build Reference</a>.</p>\n"
         }
       },
       "preferredOrder": [
@@ -805,12 +805,12 @@
         "gradleImage"
       ],
       "additionalProperties": false,
-      "description": "(beta) describes how to do a remote build on [Google Cloud Build](https://cloud.google.com/cloud-build/docs/). Docker and Jib artifacts can be built on Cloud Build. The `projectId` needs to be provided and the currently logged in user should be given permissions to trigger new builds.",
-      "x-intellij-html-description": "(beta) describes how to do a remote build on <a href=\"https://cloud.google.com/cloud-build/docs/\">Google Cloud Build</a>. Docker and Jib artifacts can be built on Cloud Build. The <code>projectId</code> needs to be provided and the currently logged in user should be given permissions to trigger new builds.\n"
+      "description": "*beta* describes how to do a remote build on [Google Cloud Build](https://cloud.google.com/cloud-build/docs/). Docker and Jib artifacts can be built on Cloud Build. The `projectId` needs to be provided and the currently logged in user should be given permissions to trigger new builds.",
+      "x-intellij-html-description": "<p><em>beta</em> describes how to do a remote build on <a href=\"https://cloud.google.com/cloud-build/docs/\">Google Cloud Build</a>. Docker and Jib artifacts can be built on Cloud Build. The <code>projectId</code> needs to be provided and the currently logged in user should be given permissions to trigger new builds.</p>\n"
     },
     "HelmConventionConfig": {
       "description": "image config in the syntax of image.repository and image.tag.",
-      "x-intellij-html-description": "image config in the syntax of image.repository and image.tag.\n"
+      "x-intellij-html-description": "<p>image config in the syntax of image.repository and image.tag.</p>\n"
     },
     "HelmDeploy": {
       "required": [
@@ -823,22 +823,22 @@
           },
           "type": "array",
           "description": "a list of Helm releases.",
-          "x-intellij-html-description": "a list of Helm releases.\n"
+          "x-intellij-html-description": "<p>a list of Helm releases.</p>\n"
         }
       },
       "preferredOrder": [
         "releases"
       ],
       "additionalProperties": false,
-      "description": "(beta) uses the `helm` CLI to apply the charts to the cluster.",
-      "x-intellij-html-description": "(beta) uses the <code>helm</code> CLI to apply the charts to the cluster.\n"
+      "description": "*beta* uses the `helm` CLI to apply the charts to the cluster.",
+      "x-intellij-html-description": "<p><em>beta</em> uses the <code>helm</code> CLI to apply the charts to the cluster.</p>\n"
     },
     "HelmFQNConfig": {
       "properties": {
         "property": {
           "type": "string",
           "description": "defines the image config.",
-          "x-intellij-html-description": "defines the image config.\n"
+          "x-intellij-html-description": "<p>defines the image config.</p>\n"
         }
       },
       "preferredOrder": [
@@ -846,19 +846,19 @@
       ],
       "additionalProperties": false,
       "description": "image config to use the FullyQualifiedImageName as param to set.",
-      "x-intellij-html-description": "image config to use the FullyQualifiedImageName as param to set.\n"
+      "x-intellij-html-description": "<p>image config to use the FullyQualifiedImageName as param to set.</p>\n"
     },
     "HelmImageConfig": {
       "properties": {
         "fqn": {
           "$ref": "#/definitions/HelmFQNConfig",
           "description": "image configuration uses the syntax `IMAGE-NAME=IMAGE-REPOSITORY:IMAGE-TAG`.",
-          "x-intellij-html-description": "image configuration uses the syntax <code>IMAGE-NAME=IMAGE-REPOSITORY:IMAGE-TAG</code>.\n"
+          "x-intellij-html-description": "<p>image configuration uses the syntax <code>IMAGE-NAME=IMAGE-REPOSITORY:IMAGE-TAG</code>.</p>\n"
         },
         "helm": {
           "$ref": "#/definitions/HelmConventionConfig",
           "description": "image configuration uses the syntax `IMAGE-NAME.repository=IMAGE-REPOSITORY, IMAGE-NAME.tag=IMAGE-TAG`.",
-          "x-intellij-html-description": "image configuration uses the syntax <code>IMAGE-NAME.repository=IMAGE-REPOSITORY, IMAGE-NAME.tag=IMAGE-TAG</code>.\n"
+          "x-intellij-html-description": "<p>image configuration uses the syntax <code>IMAGE-NAME.repository=IMAGE-REPOSITORY, IMAGE-NAME.tag=IMAGE-TAG</code>.</p>\n"
         }
       },
       "preferredOrder": [
@@ -877,7 +877,7 @@
             "fqn": {
               "$ref": "#/definitions/HelmFQNConfig",
               "description": "image configuration uses the syntax `IMAGE-NAME=IMAGE-REPOSITORY:IMAGE-TAG`.",
-              "x-intellij-html-description": "image configuration uses the syntax <code>IMAGE-NAME=IMAGE-REPOSITORY:IMAGE-TAG</code>.\n"
+              "x-intellij-html-description": "<p>image configuration uses the syntax <code>IMAGE-NAME=IMAGE-REPOSITORY:IMAGE-TAG</code>.</p>\n"
             }
           },
           "preferredOrder": [
@@ -890,7 +890,7 @@
             "helm": {
               "$ref": "#/definitions/HelmConventionConfig",
               "description": "image configuration uses the syntax `IMAGE-NAME.repository=IMAGE-REPOSITORY, IMAGE-NAME.tag=IMAGE-TAG`.",
-              "x-intellij-html-description": "image configuration uses the syntax <code>IMAGE-NAME.repository=IMAGE-REPOSITORY, IMAGE-NAME.tag=IMAGE-TAG</code>.\n"
+              "x-intellij-html-description": "<p>image configuration uses the syntax <code>IMAGE-NAME.repository=IMAGE-REPOSITORY, IMAGE-NAME.tag=IMAGE-TAG</code>.</p>\n"
             }
           },
           "preferredOrder": [
@@ -900,19 +900,19 @@
         }
       ],
       "description": "adds image configurations to the Helm `values` file.",
-      "x-intellij-html-description": "adds image configurations to the Helm <code>values</code> file.\n"
+      "x-intellij-html-description": "<p>adds image configurations to the Helm <code>values</code> file.</p>\n"
     },
     "HelmPackaged": {
       "properties": {
         "appVersion": {
           "type": "string",
           "description": "sets the `appVersion` on the chart to this version.",
-          "x-intellij-html-description": "sets the <code>appVersion</code> on the chart to this version.\n"
+          "x-intellij-html-description": "<p>sets the <code>appVersion</code> on the chart to this version.</p>\n"
         },
         "version": {
           "type": "string",
           "description": "sets the `version` on the chart to this semver version.",
-          "x-intellij-html-description": "sets the <code>version</code> on the chart to this semver version.\n"
+          "x-intellij-html-description": "<p>sets the <code>version</code> on the chart to this semver version.</p>\n"
         }
       },
       "preferredOrder": [
@@ -921,7 +921,7 @@
       ],
       "additionalProperties": false,
       "description": "parameters for packaging helm chart (`helm package`).",
-      "x-intellij-html-description": "parameters for packaging helm chart (<code>helm package</code>).\n"
+      "x-intellij-html-description": "<p>parameters for packaging helm chart (<code>helm package</code>).</p>\n"
     },
     "HelmRelease": {
       "required": [
@@ -932,39 +932,39 @@
         "chartPath": {
           "type": "string",
           "description": "path to the Helm chart.",
-          "x-intellij-html-description": "path to the Helm chart.\n"
+          "x-intellij-html-description": "<p>path to the Helm chart.</p>\n"
         },
         "imageStrategy": {
           "$ref": "#/definitions/HelmImageStrategy",
           "description": "adds image configurations to the Helm `values` file.",
-          "x-intellij-html-description": "adds image configurations to the Helm <code>values</code> file.\n"
+          "x-intellij-html-description": "<p>adds image configurations to the Helm <code>values</code> file.</p>\n"
         },
         "name": {
           "type": "string",
           "description": "name of the Helm release.",
-          "x-intellij-html-description": "name of the Helm release.\n"
+          "x-intellij-html-description": "<p>name of the Helm release.</p>\n"
         },
         "namespace": {
           "type": "string",
           "description": "Kubernetes namespace.",
-          "x-intellij-html-description": "Kubernetes namespace.\n"
+          "x-intellij-html-description": "<p>Kubernetes namespace.</p>\n"
         },
         "overrides": {
           "additionalProperties": {},
           "type": "object",
           "description": "key-value pairs. If present, Skaffold will build a Helm `values` file that overrides the original and use it to call Helm CLI (`--f` flag).",
-          "x-intellij-html-description": "key-value pairs. If present, Skaffold will build a Helm <code>values</code> file that overrides the original and use it to call Helm CLI (<code>--f</code> flag).\n",
+          "x-intellij-html-description": "<p>key-value pairs. If present, Skaffold will build a Helm <code>values</code> file that overrides the original and use it to call Helm CLI (<code>--f</code> flag).</p>\n",
           "default": "{}"
         },
         "packaged": {
           "$ref": "#/definitions/HelmPackaged",
           "description": "parameters for packaging helm chart (`helm package`).",
-          "x-intellij-html-description": "parameters for packaging helm chart (<code>helm package</code>).\n"
+          "x-intellij-html-description": "<p>parameters for packaging helm chart (<code>helm package</code>).</p>\n"
         },
         "recreatePods": {
           "type": "boolean",
           "description": "if `true`, Skaffold will send `--recreate-pods` flag to Helm CLI.",
-          "x-intellij-html-description": "if <code>true</code>, Skaffold will send <code>--recreate-pods</code> flag to Helm CLI.\n",
+          "x-intellij-html-description": "<p>if <code>true</code>, Skaffold will send <code>--recreate-pods</code> flag to Helm CLI.</p>\n",
           "default": "false"
         },
         "setValueTemplates": {
@@ -973,7 +973,7 @@
           },
           "type": "object",
           "description": "key-value pairs. If present, Skaffold will try to parse the value part of each key-value pair using environment variables in the system, then send `--set` flag to Helm CLI and append all parsed pairs after the flag.",
-          "x-intellij-html-description": "key-value pairs. If present, Skaffold will try to parse the value part of each key-value pair using environment variables in the system, then send <code>--set</code> flag to Helm CLI and append all parsed pairs after the flag.\n",
+          "x-intellij-html-description": "<p>key-value pairs. If present, Skaffold will try to parse the value part of each key-value pair using environment variables in the system, then send <code>--set</code> flag to Helm CLI and append all parsed pairs after the flag.</p>\n",
           "default": "{}"
         },
         "setValues": {
@@ -982,13 +982,13 @@
           },
           "type": "object",
           "description": "key-value pairs. If present, Skaffold will send `--set` flag to Helm CLI and append all pairs after the flag.",
-          "x-intellij-html-description": "key-value pairs. If present, Skaffold will send <code>--set</code> flag to Helm CLI and append all pairs after the flag.\n",
+          "x-intellij-html-description": "<p>key-value pairs. If present, Skaffold will send <code>--set</code> flag to Helm CLI and append all pairs after the flag.</p>\n",
           "default": "{}"
         },
         "skipBuildDependencies": {
           "type": "boolean",
           "description": "should build dependencies be skipped.",
-          "x-intellij-html-description": "should build dependencies be skipped.\n",
+          "x-intellij-html-description": "<p>should build dependencies be skipped.</p>\n",
           "default": "false"
         },
         "values": {
@@ -997,7 +997,7 @@
           },
           "type": "object",
           "description": "key-value pairs supplementing the Helm `values` file\".",
-          "x-intellij-html-description": "key-value pairs supplementing the Helm <code>values</code> file&quot;.\n",
+          "x-intellij-html-description": "<p>key-value pairs supplementing the Helm <code>values</code> file&quot;.</p>\n",
           "default": "{}"
         },
         "valuesFiles": {
@@ -1006,18 +1006,18 @@
           },
           "type": "array",
           "description": "paths to the Helm `values` files\".",
-          "x-intellij-html-description": "paths to the Helm <code>values</code> files&quot;.\n",
+          "x-intellij-html-description": "<p>paths to the Helm <code>values</code> files&quot;.</p>\n",
           "default": "[]"
         },
         "version": {
           "type": "string",
           "description": "version of the chart.",
-          "x-intellij-html-description": "version of the chart.\n"
+          "x-intellij-html-description": "<p>version of the chart.</p>\n"
         },
         "wait": {
           "type": "boolean",
           "description": "if `true`, Skaffold will send `--wait` flag to Helm CLI.",
-          "x-intellij-html-description": "if <code>true</code>, Skaffold will send <code>--wait</code> flag to Helm CLI.\n",
+          "x-intellij-html-description": "<p>if <code>true</code>, Skaffold will send <code>--wait</code> flag to Helm CLI.</p>\n",
           "default": "false"
         }
       },
@@ -1047,18 +1047,18 @@
         "from": {
           "type": "string",
           "description": "source position in the yaml, used for `copy` or `move` operations.",
-          "x-intellij-html-description": "source position in the yaml, used for <code>copy</code> or <code>move</code> operations.\n"
+          "x-intellij-html-description": "<p>source position in the yaml, used for <code>copy</code> or <code>move</code> operations.</p>\n"
         },
         "op": {
           "type": "string",
           "description": "operation carried by the patch: `add`, `remove`, `replace`, `move`, `copy` or `test`.",
-          "x-intellij-html-description": "operation carried by the patch: <code>add</code>, <code>remove</code>, <code>replace</code>, <code>move</code>, <code>copy</code> or <code>test</code>.\n",
+          "x-intellij-html-description": "<p>operation carried by the patch: <code>add</code>, <code>remove</code>, <code>replace</code>, <code>move</code>, <code>copy</code> or <code>test</code>.</p>\n",
           "default": "replace"
         },
         "path": {
           "type": "string",
           "description": "position in the yaml where the operation takes place. For example, this targets the `dockerfile` of the first artifact built.",
-          "x-intellij-html-description": "position in the yaml where the operation takes place. For example, this targets the <code>dockerfile</code> of the first artifact built.\n",
+          "x-intellij-html-description": "<p>position in the yaml where the operation takes place. For example, this targets the <code>dockerfile</code> of the first artifact built.</p>\n",
           "examples": [
             "/build/artifacts/0/docker/dockerfile"
           ]
@@ -1066,7 +1066,7 @@
         "value": {
           "type": "object",
           "description": "value to apply. Can be any portion of yaml.",
-          "x-intellij-html-description": "value to apply. Can be any portion of yaml.\n"
+          "x-intellij-html-description": "<p>value to apply. Can be any portion of yaml.</p>\n"
         }
       },
       "preferredOrder": [
@@ -1077,7 +1077,7 @@
       ],
       "additionalProperties": false,
       "description": "patch to be applied by a profile.",
-      "x-intellij-html-description": "patch to be applied by a profile.\n"
+      "x-intellij-html-description": "<p>patch to be applied by a profile.</p>\n"
     },
     "JibGradleArtifact": {
       "properties": {
@@ -1087,7 +1087,7 @@
           },
           "type": "array",
           "description": "additional build flags passed to Gradle.",
-          "x-intellij-html-description": "additional build flags passed to Gradle.\n",
+          "x-intellij-html-description": "<p>additional build flags passed to Gradle.</p>\n",
           "default": "[]",
           "examples": [
             "[\"--no-build-cache\"]"
@@ -1096,7 +1096,7 @@
         "project": {
           "type": "string",
           "description": "selects which Gradle project to build.",
-          "x-intellij-html-description": "selects which Gradle project to build.\n"
+          "x-intellij-html-description": "<p>selects which Gradle project to build.</p>\n"
         }
       },
       "preferredOrder": [
@@ -1104,8 +1104,8 @@
         "args"
       ],
       "additionalProperties": false,
-      "description": "(alpha) builds images using the [Jib plugin for Gradle](https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin).",
-      "x-intellij-html-description": "(alpha) builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin\">Jib plugin for Gradle</a>.\n"
+      "description": "*alpha* builds images using the [Jib plugin for Gradle](https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin).",
+      "x-intellij-html-description": "<p><em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin\">Jib plugin for Gradle</a>.</p>\n"
     },
     "JibMavenArtifact": {
       "properties": {
@@ -1115,7 +1115,7 @@
           },
           "type": "array",
           "description": "additional build flags passed to Maven.",
-          "x-intellij-html-description": "additional build flags passed to Maven.\n",
+          "x-intellij-html-description": "<p>additional build flags passed to Maven.</p>\n",
           "default": "[]",
           "examples": [
             "[\"-x\", \"-DskipTests\"]"
@@ -1124,12 +1124,12 @@
         "module": {
           "type": "string",
           "description": "selects which Maven module to build, for a multi module project.",
-          "x-intellij-html-description": "selects which Maven module to build, for a multi module project.\n"
+          "x-intellij-html-description": "<p>selects which Maven module to build, for a multi module project.</p>\n"
         },
         "profile": {
           "type": "string",
           "description": "selects which Maven profile to activate.",
-          "x-intellij-html-description": "selects which Maven profile to activate.\n"
+          "x-intellij-html-description": "<p>selects which Maven profile to activate.</p>\n"
         }
       },
       "preferredOrder": [
@@ -1138,25 +1138,25 @@
         "args"
       ],
       "additionalProperties": false,
-      "description": "(alpha) builds images using the [Jib plugin for Maven](https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin).",
-      "x-intellij-html-description": "(alpha) builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin\">Jib plugin for Maven</a>.\n"
+      "description": "*alpha* builds images using the [Jib plugin for Maven](https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin).",
+      "x-intellij-html-description": "<p><em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin\">Jib plugin for Maven</a>.</p>\n"
     },
     "KanikoBuild": {
       "properties": {
         "buildContext": {
           "$ref": "#/definitions/KanikoBuildContext",
           "description": "defines where Kaniko gets the sources from.",
-          "x-intellij-html-description": "defines where Kaniko gets the sources from.\n"
+          "x-intellij-html-description": "<p>defines where Kaniko gets the sources from.</p>\n"
         },
         "cache": {
           "$ref": "#/definitions/KanikoCache",
           "description": "configures Kaniko caching. If a cache is specified, Kaniko will use a remote cache which will speed up builds.",
-          "x-intellij-html-description": "configures Kaniko caching. If a cache is specified, Kaniko will use a remote cache which will speed up builds.\n"
+          "x-intellij-html-description": "<p>configures Kaniko caching. If a cache is specified, Kaniko will use a remote cache which will speed up builds.</p>\n"
         },
         "dockerConfig": {
           "$ref": "#/definitions/DockerConfig",
           "description": "describes how to mount the local Docker configuration into the Kaniko pod.",
-          "x-intellij-html-description": "describes how to mount the local Docker configuration into the Kaniko pod.\n"
+          "x-intellij-html-description": "<p>describes how to mount the local Docker configuration into the Kaniko pod.</p>\n"
         },
         "flags": {
           "items": {
@@ -1164,34 +1164,34 @@
           },
           "type": "array",
           "description": "additional flags to be passed to Kaniko command line. See [Kaniko Additional Flags](https://github.com/GoogleContainerTools/kaniko#additional-flags).",
-          "x-intellij-html-description": "additional flags to be passed to Kaniko command line. See <a href=\"https://github.com/GoogleContainerTools/kaniko#additional-flags\">Kaniko Additional Flags</a>.\n",
+          "x-intellij-html-description": "<p>additional flags to be passed to Kaniko command line. See <a href=\"https://github.com/GoogleContainerTools/kaniko#additional-flags\">Kaniko Additional Flags</a>.</p>\n",
           "default": "[]"
         },
         "image": {
           "type": "string",
           "description": "Docker image used by the Kaniko pod. Defaults to the latest released version of `gcr.io/kaniko-project/executor`.",
-          "x-intellij-html-description": "Docker image used by the Kaniko pod. Defaults to the latest released version of <code>gcr.io/kaniko-project/executor</code>.\n"
+          "x-intellij-html-description": "<p>Docker image used by the Kaniko pod. Defaults to the latest released version of <code>gcr.io/kaniko-project/executor</code>.</p>\n"
         },
         "namespace": {
           "type": "string",
           "description": "Kubernetes namespace. Defaults to current namespace in Kubernetes configuration.",
-          "x-intellij-html-description": "Kubernetes namespace. Defaults to current namespace in Kubernetes configuration.\n"
+          "x-intellij-html-description": "<p>Kubernetes namespace. Defaults to current namespace in Kubernetes configuration.</p>\n"
         },
         "pullSecret": {
           "type": "string",
           "description": "path to the secret key file. See [Kaniko Documentation](https://github.com/GoogleContainerTools/kaniko#running-kaniko-in-a-kubernetes-cluster).",
-          "x-intellij-html-description": "path to the secret key file. See <a href=\"https://github.com/GoogleContainerTools/kaniko#running-kaniko-in-a-kubernetes-cluster\">Kaniko Documentation</a>.\n"
+          "x-intellij-html-description": "<p>path to the secret key file. See <a href=\"https://github.com/GoogleContainerTools/kaniko#running-kaniko-in-a-kubernetes-cluster\">Kaniko Documentation</a>.</p>\n"
         },
         "pullSecretName": {
           "type": "string",
           "description": "name of the Kubernetes secret for pulling the files from the build context and pushing the final image.",
-          "x-intellij-html-description": "name of the Kubernetes secret for pulling the files from the build context and pushing the final image.\n",
+          "x-intellij-html-description": "<p>name of the Kubernetes secret for pulling the files from the build context and pushing the final image.</p>\n",
           "default": "kaniko-secret"
         },
         "timeout": {
           "type": "string",
           "description": "amount of time (in seconds) that this build is allowed to run. Defaults to 20 minutes (`20m`).",
-          "x-intellij-html-description": "amount of time (in seconds) that this build is allowed to run. Defaults to 20 minutes (<code>20m</code>).\n"
+          "x-intellij-html-description": "<p>amount of time (in seconds) that this build is allowed to run. Defaults to 20 minutes (<code>20m</code>).</p>\n"
         }
       },
       "preferredOrder": [
@@ -1206,20 +1206,20 @@
         "dockerConfig"
       ],
       "additionalProperties": false,
-      "description": "(beta) describes how to do an on-cluster build using [Kaniko](https://github.com/GoogleContainerTools/kaniko).",
-      "x-intellij-html-description": "(beta) describes how to do an on-cluster build using <a href=\"https://github.com/GoogleContainerTools/kaniko\">Kaniko</a>.\n"
+      "description": "*beta* describes how to do an on-cluster build using [Kaniko](https://github.com/GoogleContainerTools/kaniko).",
+      "x-intellij-html-description": "<p><em>beta</em> describes how to do an on-cluster build using <a href=\"https://github.com/GoogleContainerTools/kaniko\">Kaniko</a>.</p>\n"
     },
     "KanikoBuildContext": {
       "properties": {
         "gcsBucket": {
           "type": "string",
           "description": "CGS bucket to which sources are uploaded by Skaffold. Kaniko will need access to that bucket to download the sources.",
-          "x-intellij-html-description": "CGS bucket to which sources are uploaded by Skaffold. Kaniko will need access to that bucket to download the sources.\n"
+          "x-intellij-html-description": "<p>CGS bucket to which sources are uploaded by Skaffold. Kaniko will need access to that bucket to download the sources.</p>\n"
         },
         "localDir": {
           "$ref": "#/definitions/LocalDir",
           "description": "configures how Kaniko mounts sources directly via an `emptyDir` volume.",
-          "x-intellij-html-description": "configures how Kaniko mounts sources directly via an <code>emptyDir</code> volume.\n"
+          "x-intellij-html-description": "<p>configures how Kaniko mounts sources directly via an <code>emptyDir</code> volume.</p>\n"
         }
       },
       "preferredOrder": [
@@ -1228,14 +1228,14 @@
       ],
       "additionalProperties": false,
       "description": "contains the different fields available to specify a Kaniko build context.",
-      "x-intellij-html-description": "contains the different fields available to specify a Kaniko build context.\n"
+      "x-intellij-html-description": "<p>contains the different fields available to specify a Kaniko build context.</p>\n"
     },
     "KanikoCache": {
       "properties": {
         "repo": {
           "type": "string",
           "description": "a remote repository to store cached layers. If none is specified, one will be inferred from the image name. See [Kaniko Caching](https://github.com/GoogleContainerTools/kaniko#caching).",
-          "x-intellij-html-description": "a remote repository to store cached layers. If none is specified, one will be inferred from the image name. See <a href=\"https://github.com/GoogleContainerTools/kaniko#caching\">Kaniko Caching</a>.\n"
+          "x-intellij-html-description": "<p>a remote repository to store cached layers. If none is specified, one will be inferred from the image name. See <a href=\"https://github.com/GoogleContainerTools/kaniko#caching\">Kaniko Caching</a>.</p>\n"
         }
       },
       "preferredOrder": [
@@ -1243,14 +1243,14 @@
       ],
       "additionalProperties": false,
       "description": "configures Kaniko caching. If a cache is specified, Kaniko will use a remote cache which will speed up builds.",
-      "x-intellij-html-description": "configures Kaniko caching. If a cache is specified, Kaniko will use a remote cache which will speed up builds.\n"
+      "x-intellij-html-description": "<p>configures Kaniko caching. If a cache is specified, Kaniko will use a remote cache which will speed up builds.</p>\n"
     },
     "KubectlDeploy": {
       "properties": {
         "flags": {
           "$ref": "#/definitions/KubectlFlags",
           "description": "additional flags passed to `kubectl`.",
-          "x-intellij-html-description": "additional flags passed to <code>kubectl</code>.\n"
+          "x-intellij-html-description": "<p>additional flags passed to <code>kubectl</code>.</p>\n"
         },
         "manifests": {
           "items": {
@@ -1258,7 +1258,7 @@
           },
           "type": "array",
           "description": "the Kubernetes yaml or json manifests.",
-          "x-intellij-html-description": "the Kubernetes yaml or json manifests.\n",
+          "x-intellij-html-description": "<p>the Kubernetes yaml or json manifests.</p>\n",
           "default": "[\"k8s/*.yaml\"]"
         },
         "remoteManifests": {
@@ -1267,7 +1267,7 @@
           },
           "type": "array",
           "description": "Kubernetes manifests in remote clusters.",
-          "x-intellij-html-description": "Kubernetes manifests in remote clusters.\n",
+          "x-intellij-html-description": "<p>Kubernetes manifests in remote clusters.</p>\n",
           "default": "[]"
         }
       },
@@ -1277,8 +1277,8 @@
         "flags"
       ],
       "additionalProperties": false,
-      "description": "(beta) uses a client side `kubectl apply` to deploy manifests. You'll need a `kubectl` CLI version installed that's compatible with your cluster.",
-      "x-intellij-html-description": "(beta) uses a client side <code>kubectl apply</code> to deploy manifests. You'll need a <code>kubectl</code> CLI version installed that's compatible with your cluster.\n"
+      "description": "*beta* uses a client side `kubectl apply` to deploy manifests. You'll need a `kubectl` CLI version installed that's compatible with your cluster.",
+      "x-intellij-html-description": "<p><em>beta</em> uses a client side <code>kubectl apply</code> to deploy manifests. You'll need a <code>kubectl</code> CLI version installed that's compatible with your cluster.</p>\n"
     },
     "KubectlFlags": {
       "properties": {
@@ -1288,7 +1288,7 @@
           },
           "type": "array",
           "description": "additional flags passed on creations (`kubectl apply`).",
-          "x-intellij-html-description": "additional flags passed on creations (<code>kubectl apply</code>).\n",
+          "x-intellij-html-description": "<p>additional flags passed on creations (<code>kubectl apply</code>).</p>\n",
           "default": "[]"
         },
         "delete": {
@@ -1297,7 +1297,7 @@
           },
           "type": "array",
           "description": "additional flags passed on deletions (`kubectl delete`).",
-          "x-intellij-html-description": "additional flags passed on deletions (<code>kubectl delete</code>).\n",
+          "x-intellij-html-description": "<p>additional flags passed on deletions (<code>kubectl delete</code>).</p>\n",
           "default": "[]"
         },
         "global": {
@@ -1306,7 +1306,7 @@
           },
           "type": "array",
           "description": "additional flags passed on every command.",
-          "x-intellij-html-description": "additional flags passed on every command.\n",
+          "x-intellij-html-description": "<p>additional flags passed on every command.</p>\n",
           "default": "[]"
         }
       },
@@ -1317,19 +1317,19 @@
       ],
       "additionalProperties": false,
       "description": "additional flags passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).",
-      "x-intellij-html-description": "additional flags passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).\n"
+      "x-intellij-html-description": "<p>additional flags passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).</p>\n"
     },
     "KustomizeDeploy": {
       "properties": {
         "flags": {
           "$ref": "#/definitions/KubectlFlags",
           "description": "additional flags passed to `kubectl`.",
-          "x-intellij-html-description": "additional flags passed to <code>kubectl</code>.\n"
+          "x-intellij-html-description": "<p>additional flags passed to <code>kubectl</code>.</p>\n"
         },
         "path": {
           "type": "string",
           "description": "path to Kustomization files.",
-          "x-intellij-html-description": "path to Kustomization files.\n",
+          "x-intellij-html-description": "<p>path to Kustomization files.</p>\n",
           "default": "."
         }
       },
@@ -1338,26 +1338,26 @@
         "flags"
       ],
       "additionalProperties": false,
-      "description": "(beta) uses the `kustomize` CLI to \"patch\" a deployment for a target environment.",
-      "x-intellij-html-description": "(beta) uses the <code>kustomize</code> CLI to &quot;patch&quot; a deployment for a target environment.\n"
+      "description": "*beta* uses the `kustomize` CLI to \"patch\" a deployment for a target environment.",
+      "x-intellij-html-description": "<p><em>beta</em> uses the <code>kustomize</code> CLI to &quot;patch&quot; a deployment for a target environment.</p>\n"
     },
     "LocalBuild": {
       "properties": {
         "push": {
           "type": "boolean",
           "description": "should images be pushed to a registry. If not specified, images are pushed only if the current Kubernetes context connects to a remote cluster.",
-          "x-intellij-html-description": "should images be pushed to a registry. If not specified, images are pushed only if the current Kubernetes context connects to a remote cluster.\n"
+          "x-intellij-html-description": "<p>should images be pushed to a registry. If not specified, images are pushed only if the current Kubernetes context connects to a remote cluster.</p>\n"
         },
         "useBuildkit": {
           "type": "boolean",
           "description": "use BuildKit to build Docker images.",
-          "x-intellij-html-description": "use BuildKit to build Docker images.\n",
+          "x-intellij-html-description": "<p>use BuildKit to build Docker images.</p>\n",
           "default": "false"
         },
         "useDockerCLI": {
           "type": "boolean",
           "description": "use `docker` command-line interface instead of Docker Engine APIs.",
-          "x-intellij-html-description": "use <code>docker</code> command-line interface instead of Docker Engine APIs.\n",
+          "x-intellij-html-description": "<p>use <code>docker</code> command-line interface instead of Docker Engine APIs.</p>\n",
           "default": "false"
         }
       },
@@ -1367,12 +1367,12 @@
         "useBuildkit"
       ],
       "additionalProperties": false,
-      "description": "(beta) describes how to do a build on the local docker daemon and optionally push to a repository.",
-      "x-intellij-html-description": "(beta) describes how to do a build on the local docker daemon and optionally push to a repository.\n"
+      "description": "*beta* describes how to do a build on the local docker daemon and optionally push to a repository.",
+      "x-intellij-html-description": "<p><em>beta</em> describes how to do a build on the local docker daemon and optionally push to a repository.</p>\n"
     },
     "LocalDir": {
       "description": "configures how Kaniko mounts sources directly via an `emptyDir` volume.",
-      "x-intellij-html-description": "configures how Kaniko mounts sources directly via an <code>emptyDir</code> volume.\n"
+      "x-intellij-html-description": "<p>configures how Kaniko mounts sources directly via an <code>emptyDir</code> volume.</p>\n"
     },
     "Profile": {
       "required": [
@@ -1385,22 +1385,22 @@
           },
           "type": "array",
           "description": "criteria by which a profile can be auto-activated.",
-          "x-intellij-html-description": "criteria by which a profile can be auto-activated.\n"
+          "x-intellij-html-description": "<p>criteria by which a profile can be auto-activated.</p>\n"
         },
         "build": {
           "$ref": "#/definitions/BuildConfig",
           "description": "replaces the main `build` configuration.",
-          "x-intellij-html-description": "replaces the main <code>build</code> configuration.\n"
+          "x-intellij-html-description": "<p>replaces the main <code>build</code> configuration.</p>\n"
         },
         "deploy": {
           "$ref": "#/definitions/DeployConfig",
           "description": "replaces the main `deploy` configuration.",
-          "x-intellij-html-description": "replaces the main <code>deploy</code> configuration.\n"
+          "x-intellij-html-description": "<p>replaces the main <code>deploy</code> configuration.</p>\n"
         },
         "name": {
           "type": "string",
           "description": "a unique profile name.",
-          "x-intellij-html-description": "a unique profile name.\n",
+          "x-intellij-html-description": "<p>a unique profile name.</p>\n",
           "examples": [
             "profile-prod"
           ]
@@ -1411,7 +1411,7 @@
           },
           "type": "array",
           "description": "a list of patches applied to the configuration. Patches use the JSON patch notation.",
-          "x-intellij-html-description": "a list of patches applied to the configuration. Patches use the JSON patch notation.\n"
+          "x-intellij-html-description": "<p>a list of patches applied to the configuration. Patches use the JSON patch notation.</p>\n"
         },
         "test": {
           "items": {
@@ -1419,7 +1419,7 @@
           },
           "type": "array",
           "description": "replaces the main `test` configuration.",
-          "x-intellij-html-description": "replaces the main <code>test</code> configuration.\n"
+          "x-intellij-html-description": "<p>replaces the main <code>test</code> configuration.</p>\n"
         }
       },
       "preferredOrder": [
@@ -1431,34 +1431,34 @@
         "activation"
       ],
       "additionalProperties": false,
-      "description": "(beta) profiles are used to override any `build`, `test` or `deploy` configuration.",
-      "x-intellij-html-description": "(beta) profiles are used to override any <code>build</code>, <code>test</code> or <code>deploy</code> configuration.\n"
+      "description": "*beta* profiles are used to override any `build`, `test` or `deploy` configuration.",
+      "x-intellij-html-description": "<p><em>beta</em> profiles are used to override any <code>build</code>, <code>test</code> or <code>deploy</code> configuration.</p>\n"
     },
     "ShaTagger": {
-      "description": "(beta) tags images with their sha256 digest.",
-      "x-intellij-html-description": "(beta) tags images with their sha256 digest.\n"
+      "description": "*beta* tags images with their sha256 digest.",
+      "x-intellij-html-description": "<p><em>beta</em> tags images with their sha256 digest.</p>\n"
     },
     "SkaffoldPipeline": {
       "properties": {
         "apiVersion": {
           "type": "string",
           "description": "version of the configuration.",
-          "x-intellij-html-description": "version of the configuration.\n"
+          "x-intellij-html-description": "<p>version of the configuration.</p>\n"
         },
         "build": {
           "$ref": "#/definitions/BuildConfig",
           "description": "describes how images are built.",
-          "x-intellij-html-description": "describes how images are built.\n"
+          "x-intellij-html-description": "<p>describes how images are built.</p>\n"
         },
         "deploy": {
           "$ref": "#/definitions/DeployConfig",
           "description": "describes how images are deployed.",
-          "x-intellij-html-description": "describes how images are deployed.\n"
+          "x-intellij-html-description": "<p>describes how images are deployed.</p>\n"
         },
         "kind": {
           "type": "string",
           "description": "always `Config`.",
-          "x-intellij-html-description": "always <code>Config</code>.\n",
+          "x-intellij-html-description": "<p>always <code>Config</code>.</p>\n",
           "default": "Config"
         },
         "profiles": {
@@ -1466,8 +1466,8 @@
             "$ref": "#/definitions/Profile"
           },
           "type": "array",
-          "description": "(beta) can override be used to `build`, `test` or `deploy` configuration.",
-          "x-intellij-html-description": "(beta) can override be used to <code>build</code>, <code>test</code> or <code>deploy</code> configuration.\n"
+          "description": "*beta* can override be used to `build`, `test` or `deploy` configuration.",
+          "x-intellij-html-description": "<p><em>beta</em> can override be used to <code>build</code>, <code>test</code> or <code>deploy</code> configuration.</p>\n"
         },
         "test": {
           "items": {
@@ -1475,7 +1475,7 @@
           },
           "type": "array",
           "description": "describes how images are tested.",
-          "x-intellij-html-description": "describes how images are tested.\n"
+          "x-intellij-html-description": "<p>describes how images are tested.</p>\n"
         }
       },
       "preferredOrder": [
@@ -1492,23 +1492,23 @@
       "properties": {
         "dateTime": {
           "$ref": "#/definitions/DateTimeTagger",
-          "description": "(beta) tags images with the build timestamp.",
-          "x-intellij-html-description": "(beta) tags images with the build timestamp.\n"
+          "description": "*beta* tags images with the build timestamp.",
+          "x-intellij-html-description": "<p><em>beta</em> tags images with the build timestamp.</p>\n"
         },
         "envTemplate": {
           "$ref": "#/definitions/EnvTemplateTagger",
-          "description": "(beta) tags images with a configurable template string.",
-          "x-intellij-html-description": "(beta) tags images with a configurable template string.\n"
+          "description": "*beta* tags images with a configurable template string.",
+          "x-intellij-html-description": "<p><em>beta</em> tags images with a configurable template string.</p>\n"
         },
         "gitCommit": {
           "$ref": "#/definitions/GitTagger",
-          "description": "(beta) tags images with the git tag or commit of the artifact's workspace.",
-          "x-intellij-html-description": "(beta) tags images with the git tag or commit of the artifact's workspace.\n"
+          "description": "*beta* tags images with the git tag or commit of the artifact's workspace.",
+          "x-intellij-html-description": "<p><em>beta</em> tags images with the git tag or commit of the artifact's workspace.</p>\n"
         },
         "sha256": {
           "$ref": "#/definitions/ShaTagger",
-          "description": "(beta) tags images with their sha256 digest.",
-          "x-intellij-html-description": "(beta) tags images with their sha256 digest.\n"
+          "description": "*beta* tags images with their sha256 digest.",
+          "x-intellij-html-description": "<p><em>beta</em> tags images with their sha256 digest.</p>\n"
         }
       },
       "preferredOrder": [
@@ -1519,7 +1519,7 @@
       ],
       "additionalProperties": false,
       "description": "contains all the configuration for the tagging step.",
-      "x-intellij-html-description": "contains all the configuration for the tagging step.\n"
+      "x-intellij-html-description": "<p>contains all the configuration for the tagging step.</p>\n"
     },
     "TestCase": {
       "required": [
@@ -1529,7 +1529,7 @@
         "image": {
           "type": "string",
           "description": "artifact on which to run those tests.",
-          "x-intellij-html-description": "artifact on which to run those tests.\n",
+          "x-intellij-html-description": "<p>artifact on which to run those tests.</p>\n",
           "examples": [
             "gcr.io/k8s-skaffold/example"
           ]
@@ -1540,7 +1540,7 @@
           },
           "type": "array",
           "description": "the [Container Structure Tests](https://github.com/GoogleContainerTools/container-structure-test) to run on that artifact.",
-          "x-intellij-html-description": "the <a href=\"https://github.com/GoogleContainerTools/container-structure-test\">Container Structure Tests</a> to run on that artifact.\n",
+          "x-intellij-html-description": "<p>the <a href=\"https://github.com/GoogleContainerTools/container-structure-test\">Container Structure Tests</a> to run on that artifact.</p>\n",
           "default": "[]",
           "examples": [
             "[\"./test/*\"]"
@@ -1553,7 +1553,7 @@
       ],
       "additionalProperties": false,
       "description": "a list of structure tests to run on images that Skaffold builds.",
-      "x-intellij-html-description": "a list of structure tests to run on images that Skaffold builds.\n"
+      "x-intellij-html-description": "<p>a list of structure tests to run on images that Skaffold builds.</p>\n"
     }
   }
 }
diff --git a/docs/content/en/schemas/v1beta6.json b/docs/content/en/schemas/v1beta6.json
index bf7df6c18c6..bc377529537 100755
--- a/docs/content/en/schemas/v1beta6.json
+++ b/docs/content/en/schemas/v1beta6.json
@@ -12,15 +12,15 @@
         "command": {
           "type": "string",
           "description": "a Skaffold command for which the profile is auto-activated.",
-          "x-intellij-html-description": "a Skaffold command for which the profile is auto-activated.\n",
+          "x-intellij-html-description": "<p>a Skaffold command for which the profile is auto-activated.</p>\n",
           "examples": [
             "dev"
           ]
         },
         "env": {
           "type": "string",
-          "description": "a key=value pair. The profile is auto-activated if an Environment Variable `key` has value `value`.",
-          "x-intellij-html-description": "a key=value pair. The profile is auto-activated if an Environment Variable <code>key</code> has value <code>value</code>.\n",
+          "description": "a `key=value` pair. The profile is auto-activated if an Environment Variable `key` has value `value`.",
+          "x-intellij-html-description": "<p>a <code>key=value</code> pair. The profile is auto-activated if an Environment Variable <code>key</code> has value <code>value</code>.</p>\n",
           "examples": [
             "ENV=production"
           ]
@@ -28,7 +28,7 @@
         "kubeContext": {
           "type": "string",
           "description": "a Kubernetes context for which the profile is auto-activated.",
-          "x-intellij-html-description": "a Kubernetes context for which the profile is auto-activated.\n",
+          "x-intellij-html-description": "<p>a Kubernetes context for which the profile is auto-activated.</p>\n",
           "examples": [
             "minikube"
           ]
@@ -41,7 +41,7 @@
       ],
       "additionalProperties": false,
       "description": "criteria by which a profile is auto-activated.",
-      "x-intellij-html-description": "criteria by which a profile is auto-activated.\n"
+      "x-intellij-html-description": "<p>criteria by which a profile is auto-activated.</p>\n"
     },
     "Artifact": {
       "required": [
@@ -52,14 +52,14 @@
           "properties": {
             "context": {
               "type": "string",
-              "description": "directory where the artifact's sources are to be found.",
-              "x-intellij-html-description": "directory where the artifact's sources are to be found.\n",
+              "description": "directory containing the artifact's sources.",
+              "x-intellij-html-description": "<p>directory containing the artifact's sources.</p>\n",
               "default": "."
             },
             "image": {
               "type": "string",
               "description": "name of the image to be built.",
-              "x-intellij-html-description": "name of the image to be built.\n",
+              "x-intellij-html-description": "<p>name of the image to be built.</p>\n",
               "examples": [
                 "gcr.io/k8s-skaffold/example"
               ]
@@ -67,15 +67,15 @@
             "plugin": {
               "$ref": "#/definitions/BuilderPlugin",
               "description": "plugin used to build this artifact.",
-              "x-intellij-html-description": "plugin used to build this artifact.\n"
+              "x-intellij-html-description": "<p>plugin used to build this artifact.</p>\n"
             },
             "sync": {
               "additionalProperties": {
                 "type": "string"
               },
               "type": "object",
-              "description": "(alpha) lists local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
-              "x-intellij-html-description": "(alpha) lists local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.\n",
+              "description": "*alpha* local files synced to pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
+              "x-intellij-html-description": "<p><em>alpha</em> local files synced to pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.</p>\n",
               "default": "{}",
               "examples": [
                 "{\"*.py\": \".\", \"css/**/*.css\": \"app/css\"}"
@@ -94,19 +94,19 @@
           "properties": {
             "context": {
               "type": "string",
-              "description": "directory where the artifact's sources are to be found.",
-              "x-intellij-html-description": "directory where the artifact's sources are to be found.\n",
+              "description": "directory containing the artifact's sources.",
+              "x-intellij-html-description": "<p>directory containing the artifact's sources.</p>\n",
               "default": "."
             },
             "docker": {
               "$ref": "#/definitions/DockerArtifact",
-              "description": "(beta) describes an artifact built from a Dockerfile.",
-              "x-intellij-html-description": "(beta) describes an artifact built from a Dockerfile.\n"
+              "description": "*beta* describes an artifact built from a Dockerfile.",
+              "x-intellij-html-description": "<p><em>beta</em> describes an artifact built from a Dockerfile.</p>\n"
             },
             "image": {
               "type": "string",
               "description": "name of the image to be built.",
-              "x-intellij-html-description": "name of the image to be built.\n",
+              "x-intellij-html-description": "<p>name of the image to be built.</p>\n",
               "examples": [
                 "gcr.io/k8s-skaffold/example"
               ]
@@ -114,15 +114,15 @@
             "plugin": {
               "$ref": "#/definitions/BuilderPlugin",
               "description": "plugin used to build this artifact.",
-              "x-intellij-html-description": "plugin used to build this artifact.\n"
+              "x-intellij-html-description": "<p>plugin used to build this artifact.</p>\n"
             },
             "sync": {
               "additionalProperties": {
                 "type": "string"
               },
               "type": "object",
-              "description": "(alpha) lists local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
-              "x-intellij-html-description": "(alpha) lists local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.\n",
+              "description": "*alpha* local files synced to pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
+              "x-intellij-html-description": "<p><em>alpha</em> local files synced to pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.</p>\n",
               "default": "{}",
               "examples": [
                 "{\"*.py\": \".\", \"css/**/*.css\": \"app/css\"}"
@@ -142,19 +142,19 @@
           "properties": {
             "bazel": {
               "$ref": "#/definitions/BazelArtifact",
-              "description": "(beta) requires bazel CLI to be installed and the sources to contain [Bazel](https://bazel.build/) configuration files.",
-              "x-intellij-html-description": "(beta) requires bazel CLI to be installed and the sources to contain <a href=\"https://bazel.build/\">Bazel</a> configuration files.\n"
+              "description": "*beta* requires bazel CLI to be installed and the sources to contain [Bazel](https://bazel.build/) configuration files.",
+              "x-intellij-html-description": "<p><em>beta</em> requires bazel CLI to be installed and the sources to contain <a href=\"https://bazel.build/\">Bazel</a> configuration files.</p>\n"
             },
             "context": {
               "type": "string",
-              "description": "directory where the artifact's sources are to be found.",
-              "x-intellij-html-description": "directory where the artifact's sources are to be found.\n",
+              "description": "directory containing the artifact's sources.",
+              "x-intellij-html-description": "<p>directory containing the artifact's sources.</p>\n",
               "default": "."
             },
             "image": {
               "type": "string",
               "description": "name of the image to be built.",
-              "x-intellij-html-description": "name of the image to be built.\n",
+              "x-intellij-html-description": "<p>name of the image to be built.</p>\n",
               "examples": [
                 "gcr.io/k8s-skaffold/example"
               ]
@@ -162,15 +162,15 @@
             "plugin": {
               "$ref": "#/definitions/BuilderPlugin",
               "description": "plugin used to build this artifact.",
-              "x-intellij-html-description": "plugin used to build this artifact.\n"
+              "x-intellij-html-description": "<p>plugin used to build this artifact.</p>\n"
             },
             "sync": {
               "additionalProperties": {
                 "type": "string"
               },
               "type": "object",
-              "description": "(alpha) lists local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
-              "x-intellij-html-description": "(alpha) lists local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.\n",
+              "description": "*alpha* local files synced to pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
+              "x-intellij-html-description": "<p><em>alpha</em> local files synced to pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.</p>\n",
               "default": "{}",
               "examples": [
                 "{\"*.py\": \".\", \"css/**/*.css\": \"app/css\"}"
@@ -190,35 +190,35 @@
           "properties": {
             "context": {
               "type": "string",
-              "description": "directory where the artifact's sources are to be found.",
-              "x-intellij-html-description": "directory where the artifact's sources are to be found.\n",
+              "description": "directory containing the artifact's sources.",
+              "x-intellij-html-description": "<p>directory containing the artifact's sources.</p>\n",
               "default": "."
             },
             "image": {
               "type": "string",
               "description": "name of the image to be built.",
-              "x-intellij-html-description": "name of the image to be built.\n",
+              "x-intellij-html-description": "<p>name of the image to be built.</p>\n",
               "examples": [
                 "gcr.io/k8s-skaffold/example"
               ]
             },
             "jibMaven": {
               "$ref": "#/definitions/JibMavenArtifact",
-              "description": "(alpha) builds images using the [Jib plugin for Maven](https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin).",
-              "x-intellij-html-description": "(alpha) builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin\">Jib plugin for Maven</a>.\n"
+              "description": "*alpha* builds images using the [Jib plugin for Maven](https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin).",
+              "x-intellij-html-description": "<p><em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin\">Jib plugin for Maven</a>.</p>\n"
             },
             "plugin": {
               "$ref": "#/definitions/BuilderPlugin",
               "description": "plugin used to build this artifact.",
-              "x-intellij-html-description": "plugin used to build this artifact.\n"
+              "x-intellij-html-description": "<p>plugin used to build this artifact.</p>\n"
             },
             "sync": {
               "additionalProperties": {
                 "type": "string"
               },
               "type": "object",
-              "description": "(alpha) lists local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
-              "x-intellij-html-description": "(alpha) lists local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.\n",
+              "description": "*alpha* local files synced to pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
+              "x-intellij-html-description": "<p><em>alpha</em> local files synced to pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.</p>\n",
               "default": "{}",
               "examples": [
                 "{\"*.py\": \".\", \"css/**/*.css\": \"app/css\"}"
@@ -238,35 +238,35 @@
           "properties": {
             "context": {
               "type": "string",
-              "description": "directory where the artifact's sources are to be found.",
-              "x-intellij-html-description": "directory where the artifact's sources are to be found.\n",
+              "description": "directory containing the artifact's sources.",
+              "x-intellij-html-description": "<p>directory containing the artifact's sources.</p>\n",
               "default": "."
             },
             "image": {
               "type": "string",
               "description": "name of the image to be built.",
-              "x-intellij-html-description": "name of the image to be built.\n",
+              "x-intellij-html-description": "<p>name of the image to be built.</p>\n",
               "examples": [
                 "gcr.io/k8s-skaffold/example"
               ]
             },
             "jibGradle": {
               "$ref": "#/definitions/JibGradleArtifact",
-              "description": "(alpha) builds images using the [Jib plugin for Gradle](https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin).",
-              "x-intellij-html-description": "(alpha) builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin\">Jib plugin for Gradle</a>.\n"
+              "description": "*alpha* builds images using the [Jib plugin for Gradle](https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin).",
+              "x-intellij-html-description": "<p><em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin\">Jib plugin for Gradle</a>.</p>\n"
             },
             "plugin": {
               "$ref": "#/definitions/BuilderPlugin",
               "description": "plugin used to build this artifact.",
-              "x-intellij-html-description": "plugin used to build this artifact.\n"
+              "x-intellij-html-description": "<p>plugin used to build this artifact.</p>\n"
             },
             "sync": {
               "additionalProperties": {
                 "type": "string"
               },
               "type": "object",
-              "description": "(alpha) lists local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
-              "x-intellij-html-description": "(alpha) lists local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.\n",
+              "description": "*alpha* local files synced to pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
+              "x-intellij-html-description": "<p><em>alpha</em> local files synced to pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.</p>\n",
               "default": "{}",
               "examples": [
                 "{\"*.py\": \".\", \"css/**/*.css\": \"app/css\"}"
@@ -284,29 +284,29 @@
         }
       ],
       "description": "items that need to be built, along with the context in which they should be built.",
-      "x-intellij-html-description": "items that need to be built, along with the context in which they should be built.\n"
+      "x-intellij-html-description": "<p>items that need to be built, along with the context in which they should be built.</p>\n"
     },
     "ArtifactType": {
       "properties": {
         "bazel": {
           "$ref": "#/definitions/BazelArtifact",
-          "description": "(beta) requires bazel CLI to be installed and the sources to contain [Bazel](https://bazel.build/) configuration files.",
-          "x-intellij-html-description": "(beta) requires bazel CLI to be installed and the sources to contain <a href=\"https://bazel.build/\">Bazel</a> configuration files.\n"
+          "description": "*beta* requires bazel CLI to be installed and the sources to contain [Bazel](https://bazel.build/) configuration files.",
+          "x-intellij-html-description": "<p><em>beta</em> requires bazel CLI to be installed and the sources to contain <a href=\"https://bazel.build/\">Bazel</a> configuration files.</p>\n"
         },
         "docker": {
           "$ref": "#/definitions/DockerArtifact",
-          "description": "(beta) describes an artifact built from a Dockerfile.",
-          "x-intellij-html-description": "(beta) describes an artifact built from a Dockerfile.\n"
+          "description": "*beta* describes an artifact built from a Dockerfile.",
+          "x-intellij-html-description": "<p><em>beta</em> describes an artifact built from a Dockerfile.</p>\n"
         },
         "jibGradle": {
           "$ref": "#/definitions/JibGradleArtifact",
-          "description": "(alpha) builds images using the [Jib plugin for Gradle](https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin).",
-          "x-intellij-html-description": "(alpha) builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin\">Jib plugin for Gradle</a>.\n"
+          "description": "*alpha* builds images using the [Jib plugin for Gradle](https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin).",
+          "x-intellij-html-description": "<p><em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin\">Jib plugin for Gradle</a>.</p>\n"
         },
         "jibMaven": {
           "$ref": "#/definitions/JibMavenArtifact",
-          "description": "(alpha) builds images using the [Jib plugin for Maven](https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin).",
-          "x-intellij-html-description": "(alpha) builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin\">Jib plugin for Maven</a>.\n"
+          "description": "*alpha* builds images using the [Jib plugin for Maven](https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin).",
+          "x-intellij-html-description": "<p><em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin\">Jib plugin for Maven</a>.</p>\n"
         }
       },
       "preferredOrder": [
@@ -317,7 +317,7 @@
       ],
       "additionalProperties": false,
       "description": "describes how to build an artifact.",
-      "x-intellij-html-description": "describes how to build an artifact.\n"
+      "x-intellij-html-description": "<p>describes how to build an artifact.</p>\n"
     },
     "BazelArtifact": {
       "required": [
@@ -330,7 +330,7 @@
           },
           "type": "array",
           "description": "additional args to pass to `bazel build`.",
-          "x-intellij-html-description": "additional args to pass to <code>bazel build</code>.\n",
+          "x-intellij-html-description": "<p>additional args to pass to <code>bazel build</code>.</p>\n",
           "default": "[]",
           "examples": [
             "[\"-flag\", \"--otherflag\"]"
@@ -339,7 +339,7 @@
         "target": {
           "type": "string",
           "description": "`bazel build` target to run.",
-          "x-intellij-html-description": "<code>bazel build</code> target to run.\n",
+          "x-intellij-html-description": "<p><code>bazel build</code> target to run.</p>\n",
           "examples": [
             "//:skaffold_example.tar"
           ]
@@ -350,8 +350,8 @@
         "args"
       ],
       "additionalProperties": false,
-      "description": "(beta) describes an artifact built with [Bazel](https://bazel.build/).",
-      "x-intellij-html-description": "(beta) describes an artifact built with <a href=\"https://bazel.build/\">Bazel</a>.\n"
+      "description": "*beta* describes an artifact built with [Bazel](https://bazel.build/).",
+      "x-intellij-html-description": "<p><em>beta</em> describes an artifact built with <a href=\"https://bazel.build/\">Bazel</a>.</p>\n"
     },
     "BuildConfig": {
       "anyOf": [
@@ -363,17 +363,17 @@
               },
               "type": "array",
               "description": "the images you're going to be building.",
-              "x-intellij-html-description": "the images you're going to be building.\n"
+              "x-intellij-html-description": "<p>the images you're going to be building.</p>\n"
             },
             "executionEnvironment": {
               "$ref": "#/definitions/ExecutionEnvironment",
               "description": "environment in which the build should run. Possible values: googleCloudBuild.",
-              "x-intellij-html-description": "environment in which the build should run. Possible values: googleCloudBuild.\n"
+              "x-intellij-html-description": "<p>environment in which the build should run. Possible values: googleCloudBuild.</p>\n"
             },
             "tagPolicy": {
               "$ref": "#/definitions/TagPolicy",
-              "description": "(beta) determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to `gitCommit: {}`.",
-              "x-intellij-html-description": "(beta) determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>.\n"
+              "description": "*beta* determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to `gitCommit: {}`.",
+              "x-intellij-html-description": "<p><em>beta</em> determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>.</p>\n"
             }
           },
           "preferredOrder": [
@@ -391,22 +391,22 @@
               },
               "type": "array",
               "description": "the images you're going to be building.",
-              "x-intellij-html-description": "the images you're going to be building.\n"
+              "x-intellij-html-description": "<p>the images you're going to be building.</p>\n"
             },
             "executionEnvironment": {
               "$ref": "#/definitions/ExecutionEnvironment",
               "description": "environment in which the build should run. Possible values: googleCloudBuild.",
-              "x-intellij-html-description": "environment in which the build should run. Possible values: googleCloudBuild.\n"
+              "x-intellij-html-description": "<p>environment in which the build should run. Possible values: googleCloudBuild.</p>\n"
             },
             "local": {
               "$ref": "#/definitions/LocalBuild",
-              "description": "(beta) describes how to do a build on the local docker daemon and optionally push to a repository.",
-              "x-intellij-html-description": "(beta) describes how to do a build on the local docker daemon and optionally push to a repository.\n"
+              "description": "*beta* describes how to do a build on the local docker daemon and optionally push to a repository.",
+              "x-intellij-html-description": "<p><em>beta</em> describes how to do a build on the local docker daemon and optionally push to a repository.</p>\n"
             },
             "tagPolicy": {
               "$ref": "#/definitions/TagPolicy",
-              "description": "(beta) determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to `gitCommit: {}`.",
-              "x-intellij-html-description": "(beta) determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>.\n"
+              "description": "*beta* determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to `gitCommit: {}`.",
+              "x-intellij-html-description": "<p><em>beta</em> determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>.</p>\n"
             }
           },
           "preferredOrder": [
@@ -425,22 +425,22 @@
               },
               "type": "array",
               "description": "the images you're going to be building.",
-              "x-intellij-html-description": "the images you're going to be building.\n"
+              "x-intellij-html-description": "<p>the images you're going to be building.</p>\n"
             },
             "executionEnvironment": {
               "$ref": "#/definitions/ExecutionEnvironment",
               "description": "environment in which the build should run. Possible values: googleCloudBuild.",
-              "x-intellij-html-description": "environment in which the build should run. Possible values: googleCloudBuild.\n"
+              "x-intellij-html-description": "<p>environment in which the build should run. Possible values: googleCloudBuild.</p>\n"
             },
             "googleCloudBuild": {
               "$ref": "#/definitions/GoogleCloudBuild",
-              "description": "(beta) describes how to do a remote build on [Google Cloud Build](https://cloud.google.com/cloud-build/).",
-              "x-intellij-html-description": "(beta) describes how to do a remote build on <a href=\"https://cloud.google.com/cloud-build/\">Google Cloud Build</a>.\n"
+              "description": "*beta* describes how to do a remote build on [Google Cloud Build](https://cloud.google.com/cloud-build/).",
+              "x-intellij-html-description": "<p><em>beta</em> describes how to do a remote build on <a href=\"https://cloud.google.com/cloud-build/\">Google Cloud Build</a>.</p>\n"
             },
             "tagPolicy": {
               "$ref": "#/definitions/TagPolicy",
-              "description": "(beta) determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to `gitCommit: {}`.",
-              "x-intellij-html-description": "(beta) determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>.\n"
+              "description": "*beta* determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to `gitCommit: {}`.",
+              "x-intellij-html-description": "<p><em>beta</em> determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>.</p>\n"
             }
           },
           "preferredOrder": [
@@ -459,22 +459,22 @@
               },
               "type": "array",
               "description": "the images you're going to be building.",
-              "x-intellij-html-description": "the images you're going to be building.\n"
+              "x-intellij-html-description": "<p>the images you're going to be building.</p>\n"
             },
             "executionEnvironment": {
               "$ref": "#/definitions/ExecutionEnvironment",
               "description": "environment in which the build should run. Possible values: googleCloudBuild.",
-              "x-intellij-html-description": "environment in which the build should run. Possible values: googleCloudBuild.\n"
+              "x-intellij-html-description": "<p>environment in which the build should run. Possible values: googleCloudBuild.</p>\n"
             },
             "kaniko": {
               "$ref": "#/definitions/KanikoBuild",
-              "description": "(beta) describes how to do an on-cluster build using [Kaniko](https://github.com/GoogleContainerTools/kaniko).",
-              "x-intellij-html-description": "(beta) describes how to do an on-cluster build using <a href=\"https://github.com/GoogleContainerTools/kaniko\">Kaniko</a>.\n"
+              "description": "*beta* describes how to do an on-cluster build using [Kaniko](https://github.com/GoogleContainerTools/kaniko).",
+              "x-intellij-html-description": "<p><em>beta</em> describes how to do an on-cluster build using <a href=\"https://github.com/GoogleContainerTools/kaniko\">Kaniko</a>.</p>\n"
             },
             "tagPolicy": {
               "$ref": "#/definitions/TagPolicy",
-              "description": "(beta) determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to `gitCommit: {}`.",
-              "x-intellij-html-description": "(beta) determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>.\n"
+              "description": "*beta* determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to `gitCommit: {}`.",
+              "x-intellij-html-description": "<p><em>beta</em> determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>.</p>\n"
             }
           },
           "preferredOrder": [
@@ -487,24 +487,24 @@
         }
       ],
       "description": "contains all the configuration for the build steps.",
-      "x-intellij-html-description": "contains all the configuration for the build steps.\n"
+      "x-intellij-html-description": "<p>contains all the configuration for the build steps.</p>\n"
     },
     "BuildType": {
       "properties": {
         "googleCloudBuild": {
           "$ref": "#/definitions/GoogleCloudBuild",
-          "description": "(beta) describes how to do a remote build on [Google Cloud Build](https://cloud.google.com/cloud-build/).",
-          "x-intellij-html-description": "(beta) describes how to do a remote build on <a href=\"https://cloud.google.com/cloud-build/\">Google Cloud Build</a>.\n"
+          "description": "*beta* describes how to do a remote build on [Google Cloud Build](https://cloud.google.com/cloud-build/).",
+          "x-intellij-html-description": "<p><em>beta</em> describes how to do a remote build on <a href=\"https://cloud.google.com/cloud-build/\">Google Cloud Build</a>.</p>\n"
         },
         "kaniko": {
           "$ref": "#/definitions/KanikoBuild",
-          "description": "(beta) describes how to do an on-cluster build using [Kaniko](https://github.com/GoogleContainerTools/kaniko).",
-          "x-intellij-html-description": "(beta) describes how to do an on-cluster build using <a href=\"https://github.com/GoogleContainerTools/kaniko\">Kaniko</a>.\n"
+          "description": "*beta* describes how to do an on-cluster build using [Kaniko](https://github.com/GoogleContainerTools/kaniko).",
+          "x-intellij-html-description": "<p><em>beta</em> describes how to do an on-cluster build using <a href=\"https://github.com/GoogleContainerTools/kaniko\">Kaniko</a>.</p>\n"
         },
         "local": {
           "$ref": "#/definitions/LocalBuild",
-          "description": "(beta) describes how to do a build on the local docker daemon and optionally push to a repository.",
-          "x-intellij-html-description": "(beta) describes how to do a build on the local docker daemon and optionally push to a repository.\n"
+          "description": "*beta* describes how to do a build on the local docker daemon and optionally push to a repository.",
+          "x-intellij-html-description": "<p><em>beta</em> describes how to do a build on the local docker daemon and optionally push to a repository.</p>\n"
         }
       },
       "preferredOrder": [
@@ -514,20 +514,20 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.",
-      "x-intellij-html-description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.\n"
+      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the build step. Only one field should be populated.</p>\n"
     },
     "BuilderPlugin": {
       "properties": {
         "name": {
           "type": "string",
           "description": "name of the build plugin.",
-          "x-intellij-html-description": "name of the build plugin.\n"
+          "x-intellij-html-description": "<p>name of the build plugin.</p>\n"
         },
         "properties": {
           "additionalProperties": {},
           "type": "object",
           "description": "key-value pairs passed to the plugin.",
-          "x-intellij-html-description": "key-value pairs passed to the plugin.\n",
+          "x-intellij-html-description": "<p>key-value pairs passed to the plugin.</p>\n",
           "default": "{}"
         }
       },
@@ -537,20 +537,20 @@
       ],
       "additionalProperties": false,
       "description": "contains all fields necessary for specifying a build plugin.",
-      "x-intellij-html-description": "contains all fields necessary for specifying a build plugin.\n"
+      "x-intellij-html-description": "<p>contains all fields necessary for specifying a build plugin.</p>\n"
     },
     "DateTimeTagger": {
       "properties": {
         "format": {
           "type": "string",
           "description": "formats the date and time. See [#Time.Format](https://golang.org/pkg/time/#Time.Format).",
-          "x-intellij-html-description": "formats the date and time. See <a href=\"https://golang.org/pkg/time/#Time.Format\">#Time.Format</a>.\n",
+          "x-intellij-html-description": "<p>formats the date and time. See <a href=\"https://golang.org/pkg/time/#Time.Format\">#Time.Format</a>.</p>\n",
           "default": "2006-01-02_15-04-05.999_MST"
         },
         "timezone": {
           "type": "string",
           "description": "sets the timezone for the date and time. See [Time.LoadLocation](https://golang.org/pkg/time/#Time.LoadLocation). Defaults to the local timezone.",
-          "x-intellij-html-description": "sets the timezone for the date and time. See <a href=\"https://golang.org/pkg/time/#Time.LoadLocation\">Time.LoadLocation</a>. Defaults to the local timezone.\n"
+          "x-intellij-html-description": "<p>sets the timezone for the date and time. See <a href=\"https://golang.org/pkg/time/#Time.LoadLocation\">Time.LoadLocation</a>. Defaults to the local timezone.</p>\n"
         }
       },
       "preferredOrder": [
@@ -558,8 +558,8 @@
         "timezone"
       ],
       "additionalProperties": false,
-      "description": "(beta) tags images with the build timestamp.",
-      "x-intellij-html-description": "(beta) tags images with the build timestamp.\n"
+      "description": "*beta* tags images with the build timestamp.",
+      "x-intellij-html-description": "<p><em>beta</em> tags images with the build timestamp.</p>\n"
     },
     "DeployConfig": {
       "anyOf": [
@@ -570,8 +570,8 @@
           "properties": {
             "helm": {
               "$ref": "#/definitions/HelmDeploy",
-              "description": "(beta) uses the `helm` CLI to apply the charts to the cluster.",
-              "x-intellij-html-description": "(beta) uses the <code>helm</code> CLI to apply the charts to the cluster.\n"
+              "description": "*beta* uses the `helm` CLI to apply the charts to the cluster.",
+              "x-intellij-html-description": "<p><em>beta</em> uses the <code>helm</code> CLI to apply the charts to the cluster.</p>\n"
             }
           },
           "preferredOrder": [
@@ -583,8 +583,8 @@
           "properties": {
             "kubectl": {
               "$ref": "#/definitions/KubectlDeploy",
-              "description": "(beta) uses a client side `kubectl apply` to deploy manifests. You'll need a `kubectl` CLI version installed that's compatible with your cluster.",
-              "x-intellij-html-description": "(beta) uses a client side <code>kubectl apply</code> to deploy manifests. You'll need a <code>kubectl</code> CLI version installed that's compatible with your cluster.\n"
+              "description": "*beta* uses a client side `kubectl apply` to deploy manifests. You'll need a `kubectl` CLI version installed that's compatible with your cluster.",
+              "x-intellij-html-description": "<p><em>beta</em> uses a client side <code>kubectl apply</code> to deploy manifests. You'll need a <code>kubectl</code> CLI version installed that's compatible with your cluster.</p>\n"
             }
           },
           "preferredOrder": [
@@ -596,8 +596,8 @@
           "properties": {
             "kustomize": {
               "$ref": "#/definitions/KustomizeDeploy",
-              "description": "(beta) uses the `kustomize` CLI to \"patch\" a deployment for a target environment.",
-              "x-intellij-html-description": "(beta) uses the <code>kustomize</code> CLI to &quot;patch&quot; a deployment for a target environment.\n"
+              "description": "*beta* uses the `kustomize` CLI to \"patch\" a deployment for a target environment.",
+              "x-intellij-html-description": "<p><em>beta</em> uses the <code>kustomize</code> CLI to &quot;patch&quot; a deployment for a target environment.</p>\n"
             }
           },
           "preferredOrder": [
@@ -607,24 +607,24 @@
         }
       ],
       "description": "contains all the configuration needed by the deploy steps.",
-      "x-intellij-html-description": "contains all the configuration needed by the deploy steps.\n"
+      "x-intellij-html-description": "<p>contains all the configuration needed by the deploy steps.</p>\n"
     },
     "DeployType": {
       "properties": {
         "helm": {
           "$ref": "#/definitions/HelmDeploy",
-          "description": "(beta) uses the `helm` CLI to apply the charts to the cluster.",
-          "x-intellij-html-description": "(beta) uses the <code>helm</code> CLI to apply the charts to the cluster.\n"
+          "description": "*beta* uses the `helm` CLI to apply the charts to the cluster.",
+          "x-intellij-html-description": "<p><em>beta</em> uses the <code>helm</code> CLI to apply the charts to the cluster.</p>\n"
         },
         "kubectl": {
           "$ref": "#/definitions/KubectlDeploy",
-          "description": "(beta) uses a client side `kubectl apply` to deploy manifests. You'll need a `kubectl` CLI version installed that's compatible with your cluster.",
-          "x-intellij-html-description": "(beta) uses a client side <code>kubectl apply</code> to deploy manifests. You'll need a <code>kubectl</code> CLI version installed that's compatible with your cluster.\n"
+          "description": "*beta* uses a client side `kubectl apply` to deploy manifests. You'll need a `kubectl` CLI version installed that's compatible with your cluster.",
+          "x-intellij-html-description": "<p><em>beta</em> uses a client side <code>kubectl apply</code> to deploy manifests. You'll need a <code>kubectl</code> CLI version installed that's compatible with your cluster.</p>\n"
         },
         "kustomize": {
           "$ref": "#/definitions/KustomizeDeploy",
-          "description": "(beta) uses the `kustomize` CLI to \"patch\" a deployment for a target environment.",
-          "x-intellij-html-description": "(beta) uses the <code>kustomize</code> CLI to &quot;patch&quot; a deployment for a target environment.\n"
+          "description": "*beta* uses the `kustomize` CLI to \"patch\" a deployment for a target environment.",
+          "x-intellij-html-description": "<p><em>beta</em> uses the <code>kustomize</code> CLI to &quot;patch&quot; a deployment for a target environment.</p>\n"
         }
       },
       "preferredOrder": [
@@ -634,7 +634,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.",
-      "x-intellij-html-description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.\n"
+      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.</p>\n"
     },
     "DockerArtifact": {
       "properties": {
@@ -644,7 +644,7 @@
           },
           "type": "object",
           "description": "arguments passed to the docker build.",
-          "x-intellij-html-description": "arguments passed to the docker build.\n",
+          "x-intellij-html-description": "<p>arguments passed to the docker build.</p>\n",
           "default": "{}",
           "examples": [
             "{\"key1\": \"value1\", \"key2\": \"value2\"}"
@@ -655,8 +655,8 @@
             "type": "string"
           },
           "type": "array",
-          "description": "the Docker images to consider as cache sources.",
-          "x-intellij-html-description": "the Docker images to consider as cache sources.\n",
+          "description": "the Docker images used as cache sources.",
+          "x-intellij-html-description": "<p>the Docker images used as cache sources.</p>\n",
           "default": "[]",
           "examples": [
             "[\"golang:1.10.1-alpine3.7\", \"alpine:3.7\"]"
@@ -665,13 +665,13 @@
         "dockerfile": {
           "type": "string",
           "description": "locates the Dockerfile relative to workspace.",
-          "x-intellij-html-description": "locates the Dockerfile relative to workspace.\n",
+          "x-intellij-html-description": "<p>locates the Dockerfile relative to workspace.</p>\n",
           "default": "Dockerfile"
         },
         "target": {
           "type": "string",
           "description": "Dockerfile target name to build.",
-          "x-intellij-html-description": "Dockerfile target name to build.\n"
+          "x-intellij-html-description": "<p>Dockerfile target name to build.</p>\n"
         }
       },
       "preferredOrder": [
@@ -681,20 +681,20 @@
         "cacheFrom"
       ],
       "additionalProperties": false,
-      "description": "(beta) describes an artifact built from a Dockerfile, usually using `docker build`.",
-      "x-intellij-html-description": "(beta) describes an artifact built from a Dockerfile, usually using <code>docker build</code>.\n"
+      "description": "*beta* describes an artifact built from a Dockerfile, usually using `docker build`.",
+      "x-intellij-html-description": "<p><em>beta</em> describes an artifact built from a Dockerfile, usually using <code>docker build</code>.</p>\n"
     },
     "DockerConfig": {
       "properties": {
         "path": {
           "type": "string",
           "description": "path to the docker `config.json`.",
-          "x-intellij-html-description": "path to the docker <code>config.json</code>.\n"
+          "x-intellij-html-description": "<p>path to the docker <code>config.json</code>.</p>\n"
         },
         "secretName": {
           "type": "string",
           "description": "Kubernetes secret that will hold the Docker configuration.",
-          "x-intellij-html-description": "Kubernetes secret that will hold the Docker configuration.\n"
+          "x-intellij-html-description": "<p>Kubernetes secret that will hold the Docker configuration.</p>\n"
         }
       },
       "preferredOrder": [
@@ -703,7 +703,7 @@
       ],
       "additionalProperties": false,
       "description": "contains information about the docker `config.json` to mount.",
-      "x-intellij-html-description": "contains information about the docker <code>config.json</code> to mount.\n"
+      "x-intellij-html-description": "<p>contains information about the docker <code>config.json</code> to mount.</p>\n"
     },
     "EnvTemplateTagger": {
       "required": [
@@ -713,7 +713,7 @@
         "template": {
           "type": "string",
           "description": "used to produce the image name and tag. See golang [text/template](https://golang.org/pkg/text/template/). The template is executed against the current environment, with those variables injected:   IMAGE_NAME   |  Name of the image being built, as supplied in the artifacts section.",
-          "x-intellij-html-description": "used to produce the image name and tag. See golang <a href=\"https://golang.org/pkg/text/template/\">text/template</a>. The template is executed against the current environment, with those variables injected:   IMAGE_NAME   |  Name of the image being built, as supplied in the artifacts section.\n",
+          "x-intellij-html-description": "<p>used to produce the image name and tag. See golang <a href=\"https://golang.org/pkg/text/template/\">text/template</a>. The template is executed against the current environment, with those variables injected:   IMAGE_NAME   |  Name of the image being built, as supplied in the artifacts section.</p>\n",
           "examples": [
             "{{.RELEASE}}-{{.IMAGE_NAME}}"
           ]
@@ -723,26 +723,26 @@
         "template"
       ],
       "additionalProperties": false,
-      "description": "(beta) tags images with a configurable template string.",
-      "x-intellij-html-description": "(beta) tags images with a configurable template string.\n"
+      "description": "*beta* tags images with a configurable template string.",
+      "x-intellij-html-description": "<p><em>beta</em> tags images with a configurable template string.</p>\n"
     },
     "ExecEnvironment": {
       "type": "string",
       "description": "name of an execution environment.",
-      "x-intellij-html-description": "name of an execution environment.\n"
+      "x-intellij-html-description": "<p>name of an execution environment.</p>\n"
     },
     "ExecutionEnvironment": {
       "properties": {
         "name": {
           "$ref": "#/definitions/ExecEnvironment",
           "description": "name of the environment.",
-          "x-intellij-html-description": "name of the environment.\n"
+          "x-intellij-html-description": "<p>name of the environment.</p>\n"
         },
         "properties": {
           "additionalProperties": {},
           "type": "object",
           "description": "key-value pairs passed to the environment.",
-          "x-intellij-html-description": "key-value pairs passed to the environment.\n",
+          "x-intellij-html-description": "<p>key-value pairs passed to the environment.</p>\n",
           "default": "{}"
         }
       },
@@ -752,51 +752,51 @@
       ],
       "additionalProperties": false,
       "description": "environment in which the build should run (ex. local or in-cluster, etc.).",
-      "x-intellij-html-description": "environment in which the build should run (ex. local or in-cluster, etc.).\n"
+      "x-intellij-html-description": "<p>environment in which the build should run (ex. local or in-cluster, etc.).</p>\n"
     },
     "GitTagger": {
-      "description": "(beta) tags images with the git tag or commit of the artifact's workspace.",
-      "x-intellij-html-description": "(beta) tags images with the git tag or commit of the artifact's workspace.\n"
+      "description": "*beta* tags images with the git tag or commit of the artifact's workspace.",
+      "x-intellij-html-description": "<p><em>beta</em> tags images with the git tag or commit of the artifact's workspace.</p>\n"
     },
     "GoogleCloudBuild": {
       "properties": {
         "diskSizeGb": {
           "type": "number",
           "description": "disk size of the VM that runs the build. See [Cloud Build Reference](https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#buildoptions).",
-          "x-intellij-html-description": "disk size of the VM that runs the build. See <a href=\"https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#buildoptions\">Cloud Build Reference</a>.\n"
+          "x-intellij-html-description": "<p>disk size of the VM that runs the build. See <a href=\"https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#buildoptions\">Cloud Build Reference</a>.</p>\n"
         },
         "dockerImage": {
           "type": "string",
           "description": "image that runs a Docker build. See [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders).",
-          "x-intellij-html-description": "image that runs a Docker build. See <a href=\"https://cloud.google.com/cloud-build/docs/cloud-builders\">Cloud Builders</a>.\n",
+          "x-intellij-html-description": "<p>image that runs a Docker build. See <a href=\"https://cloud.google.com/cloud-build/docs/cloud-builders\">Cloud Builders</a>.</p>\n",
           "default": "gcr.io/cloud-builders/docker"
         },
         "gradleImage": {
           "type": "string",
           "description": "image that runs a Gradle build. See [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders).",
-          "x-intellij-html-description": "image that runs a Gradle build. See <a href=\"https://cloud.google.com/cloud-build/docs/cloud-builders\">Cloud Builders</a>.\n",
+          "x-intellij-html-description": "<p>image that runs a Gradle build. See <a href=\"https://cloud.google.com/cloud-build/docs/cloud-builders\">Cloud Builders</a>.</p>\n",
           "default": "gcr.io/cloud-builders/gradle"
         },
         "machineType": {
           "type": "string",
           "description": "type of the VM that runs the build. See [Cloud Build Reference](https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#buildoptions).",
-          "x-intellij-html-description": "type of the VM that runs the build. See <a href=\"https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#buildoptions\">Cloud Build Reference</a>.\n"
+          "x-intellij-html-description": "<p>type of the VM that runs the build. See <a href=\"https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#buildoptions\">Cloud Build Reference</a>.</p>\n"
         },
         "mavenImage": {
           "type": "string",
           "description": "image that runs a Maven build. See [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders).",
-          "x-intellij-html-description": "image that runs a Maven build. See <a href=\"https://cloud.google.com/cloud-build/docs/cloud-builders\">Cloud Builders</a>.\n",
+          "x-intellij-html-description": "<p>image that runs a Maven build. See <a href=\"https://cloud.google.com/cloud-build/docs/cloud-builders\">Cloud Builders</a>.</p>\n",
           "default": "gcr.io/cloud-builders/mvn"
         },
         "projectId": {
           "type": "string",
           "description": "ID of your Cloud Platform Project. If it is not provided, Skaffold will guess it from the image name. For example, given the artifact image name `gcr.io/myproject/image`, Skaffold will use the `myproject` GCP project.",
-          "x-intellij-html-description": "ID of your Cloud Platform Project. If it is not provided, Skaffold will guess it from the image name. For example, given the artifact image name <code>gcr.io/myproject/image</code>, Skaffold will use the <code>myproject</code> GCP project.\n"
+          "x-intellij-html-description": "<p>ID of your Cloud Platform Project. If it is not provided, Skaffold will guess it from the image name. For example, given the artifact image name <code>gcr.io/myproject/image</code>, Skaffold will use the <code>myproject</code> GCP project.</p>\n"
         },
         "timeout": {
           "type": "string",
           "description": "amount of time (in seconds) that this build should be allowed to run. See [Cloud Build Reference](https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#resource-build).",
-          "x-intellij-html-description": "amount of time (in seconds) that this build should be allowed to run. See <a href=\"https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#resource-build\">Cloud Build Reference</a>.\n"
+          "x-intellij-html-description": "<p>amount of time (in seconds) that this build should be allowed to run. See <a href=\"https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#resource-build\">Cloud Build Reference</a>.</p>\n"
         }
       },
       "preferredOrder": [
@@ -809,12 +809,12 @@
         "gradleImage"
       ],
       "additionalProperties": false,
-      "description": "(beta) describes how to do a remote build on [Google Cloud Build](https://cloud.google.com/cloud-build/docs/). Docker and Jib artifacts can be built on Cloud Build. The `projectId` needs to be provided and the currently logged in user should be given permissions to trigger new builds.",
-      "x-intellij-html-description": "(beta) describes how to do a remote build on <a href=\"https://cloud.google.com/cloud-build/docs/\">Google Cloud Build</a>. Docker and Jib artifacts can be built on Cloud Build. The <code>projectId</code> needs to be provided and the currently logged in user should be given permissions to trigger new builds.\n"
+      "description": "*beta* describes how to do a remote build on [Google Cloud Build](https://cloud.google.com/cloud-build/docs/). Docker and Jib artifacts can be built on Cloud Build. The `projectId` needs to be provided and the currently logged in user should be given permissions to trigger new builds.",
+      "x-intellij-html-description": "<p><em>beta</em> describes how to do a remote build on <a href=\"https://cloud.google.com/cloud-build/docs/\">Google Cloud Build</a>. Docker and Jib artifacts can be built on Cloud Build. The <code>projectId</code> needs to be provided and the currently logged in user should be given permissions to trigger new builds.</p>\n"
     },
     "HelmConventionConfig": {
       "description": "image config in the syntax of image.repository and image.tag.",
-      "x-intellij-html-description": "image config in the syntax of image.repository and image.tag.\n"
+      "x-intellij-html-description": "<p>image config in the syntax of image.repository and image.tag.</p>\n"
     },
     "HelmDeploy": {
       "required": [
@@ -824,7 +824,7 @@
         "flags": {
           "$ref": "#/definitions/HelmDeployFlags",
           "description": "additional option flags that are passed on the command line to `helm`.",
-          "x-intellij-html-description": "additional option flags that are passed on the command line to <code>helm</code>.\n"
+          "x-intellij-html-description": "<p>additional option flags that are passed on the command line to <code>helm</code>.</p>\n"
         },
         "releases": {
           "items": {
@@ -832,7 +832,7 @@
           },
           "type": "array",
           "description": "a list of Helm releases.",
-          "x-intellij-html-description": "a list of Helm releases.\n"
+          "x-intellij-html-description": "<p>a list of Helm releases.</p>\n"
         }
       },
       "preferredOrder": [
@@ -840,8 +840,8 @@
         "flags"
       ],
       "additionalProperties": false,
-      "description": "(beta) uses the `helm` CLI to apply the charts to the cluster.",
-      "x-intellij-html-description": "(beta) uses the <code>helm</code> CLI to apply the charts to the cluster.\n"
+      "description": "*beta* uses the `helm` CLI to apply the charts to the cluster.",
+      "x-intellij-html-description": "<p><em>beta</em> uses the <code>helm</code> CLI to apply the charts to the cluster.</p>\n"
     },
     "HelmDeployFlags": {
       "properties": {
@@ -851,7 +851,7 @@
           },
           "type": "array",
           "description": "additional flags passed on every command.",
-          "x-intellij-html-description": "additional flags passed on every command.\n",
+          "x-intellij-html-description": "<p>additional flags passed on every command.</p>\n",
           "default": "[]"
         },
         "install": {
@@ -860,7 +860,7 @@
           },
           "type": "array",
           "description": "additional flags passed to (`helm install`).",
-          "x-intellij-html-description": "additional flags passed to (<code>helm install</code>).\n",
+          "x-intellij-html-description": "<p>additional flags passed to (<code>helm install</code>).</p>\n",
           "default": "[]"
         },
         "upgrade": {
@@ -869,7 +869,7 @@
           },
           "type": "array",
           "description": "additional flags passed to (`helm upgrade`).",
-          "x-intellij-html-description": "additional flags passed to (<code>helm upgrade</code>).\n",
+          "x-intellij-html-description": "<p>additional flags passed to (<code>helm upgrade</code>).</p>\n",
           "default": "[]"
         }
       },
@@ -880,14 +880,14 @@
       ],
       "additionalProperties": false,
       "description": "additional option flags that are passed on the command line to `helm`.",
-      "x-intellij-html-description": "additional option flags that are passed on the command line to <code>helm</code>.\n"
+      "x-intellij-html-description": "<p>additional option flags that are passed on the command line to <code>helm</code>.</p>\n"
     },
     "HelmFQNConfig": {
       "properties": {
         "property": {
           "type": "string",
           "description": "defines the image config.",
-          "x-intellij-html-description": "defines the image config.\n"
+          "x-intellij-html-description": "<p>defines the image config.</p>\n"
         }
       },
       "preferredOrder": [
@@ -895,19 +895,19 @@
       ],
       "additionalProperties": false,
       "description": "image config to use the FullyQualifiedImageName as param to set.",
-      "x-intellij-html-description": "image config to use the FullyQualifiedImageName as param to set.\n"
+      "x-intellij-html-description": "<p>image config to use the FullyQualifiedImageName as param to set.</p>\n"
     },
     "HelmImageConfig": {
       "properties": {
         "fqn": {
           "$ref": "#/definitions/HelmFQNConfig",
           "description": "image configuration uses the syntax `IMAGE-NAME=IMAGE-REPOSITORY:IMAGE-TAG`.",
-          "x-intellij-html-description": "image configuration uses the syntax <code>IMAGE-NAME=IMAGE-REPOSITORY:IMAGE-TAG</code>.\n"
+          "x-intellij-html-description": "<p>image configuration uses the syntax <code>IMAGE-NAME=IMAGE-REPOSITORY:IMAGE-TAG</code>.</p>\n"
         },
         "helm": {
           "$ref": "#/definitions/HelmConventionConfig",
           "description": "image configuration uses the syntax `IMAGE-NAME.repository=IMAGE-REPOSITORY, IMAGE-NAME.tag=IMAGE-TAG`.",
-          "x-intellij-html-description": "image configuration uses the syntax <code>IMAGE-NAME.repository=IMAGE-REPOSITORY, IMAGE-NAME.tag=IMAGE-TAG</code>.\n"
+          "x-intellij-html-description": "<p>image configuration uses the syntax <code>IMAGE-NAME.repository=IMAGE-REPOSITORY, IMAGE-NAME.tag=IMAGE-TAG</code>.</p>\n"
         }
       },
       "preferredOrder": [
@@ -916,7 +916,7 @@
       ],
       "additionalProperties": false,
       "description": "describes an image configuration.",
-      "x-intellij-html-description": "describes an image configuration.\n"
+      "x-intellij-html-description": "<p>describes an image configuration.</p>\n"
     },
     "HelmImageStrategy": {
       "anyOf": [
@@ -928,7 +928,7 @@
             "fqn": {
               "$ref": "#/definitions/HelmFQNConfig",
               "description": "image configuration uses the syntax `IMAGE-NAME=IMAGE-REPOSITORY:IMAGE-TAG`.",
-              "x-intellij-html-description": "image configuration uses the syntax <code>IMAGE-NAME=IMAGE-REPOSITORY:IMAGE-TAG</code>.\n"
+              "x-intellij-html-description": "<p>image configuration uses the syntax <code>IMAGE-NAME=IMAGE-REPOSITORY:IMAGE-TAG</code>.</p>\n"
             }
           },
           "preferredOrder": [
@@ -941,7 +941,7 @@
             "helm": {
               "$ref": "#/definitions/HelmConventionConfig",
               "description": "image configuration uses the syntax `IMAGE-NAME.repository=IMAGE-REPOSITORY, IMAGE-NAME.tag=IMAGE-TAG`.",
-              "x-intellij-html-description": "image configuration uses the syntax <code>IMAGE-NAME.repository=IMAGE-REPOSITORY, IMAGE-NAME.tag=IMAGE-TAG</code>.\n"
+              "x-intellij-html-description": "<p>image configuration uses the syntax <code>IMAGE-NAME.repository=IMAGE-REPOSITORY, IMAGE-NAME.tag=IMAGE-TAG</code>.</p>\n"
             }
           },
           "preferredOrder": [
@@ -951,19 +951,19 @@
         }
       ],
       "description": "adds image configurations to the Helm `values` file.",
-      "x-intellij-html-description": "adds image configurations to the Helm <code>values</code> file.\n"
+      "x-intellij-html-description": "<p>adds image configurations to the Helm <code>values</code> file.</p>\n"
     },
     "HelmPackaged": {
       "properties": {
         "appVersion": {
           "type": "string",
           "description": "sets the `appVersion` on the chart to this version.",
-          "x-intellij-html-description": "sets the <code>appVersion</code> on the chart to this version.\n"
+          "x-intellij-html-description": "<p>sets the <code>appVersion</code> on the chart to this version.</p>\n"
         },
         "version": {
           "type": "string",
           "description": "sets the `version` on the chart to this semver version.",
-          "x-intellij-html-description": "sets the <code>version</code> on the chart to this semver version.\n"
+          "x-intellij-html-description": "<p>sets the <code>version</code> on the chart to this semver version.</p>\n"
         }
       },
       "preferredOrder": [
@@ -972,7 +972,7 @@
       ],
       "additionalProperties": false,
       "description": "parameters for packaging helm chart (`helm package`).",
-      "x-intellij-html-description": "parameters for packaging helm chart (<code>helm package</code>).\n"
+      "x-intellij-html-description": "<p>parameters for packaging helm chart (<code>helm package</code>).</p>\n"
     },
     "HelmRelease": {
       "required": [
@@ -983,39 +983,39 @@
         "chartPath": {
           "type": "string",
           "description": "path to the Helm chart.",
-          "x-intellij-html-description": "path to the Helm chart.\n"
+          "x-intellij-html-description": "<p>path to the Helm chart.</p>\n"
         },
         "imageStrategy": {
           "$ref": "#/definitions/HelmImageStrategy",
           "description": "adds image configurations to the Helm `values` file.",
-          "x-intellij-html-description": "adds image configurations to the Helm <code>values</code> file.\n"
+          "x-intellij-html-description": "<p>adds image configurations to the Helm <code>values</code> file.</p>\n"
         },
         "name": {
           "type": "string",
           "description": "name of the Helm release.",
-          "x-intellij-html-description": "name of the Helm release.\n"
+          "x-intellij-html-description": "<p>name of the Helm release.</p>\n"
         },
         "namespace": {
           "type": "string",
           "description": "Kubernetes namespace.",
-          "x-intellij-html-description": "Kubernetes namespace.\n"
+          "x-intellij-html-description": "<p>Kubernetes namespace.</p>\n"
         },
         "overrides": {
           "additionalProperties": {},
           "type": "object",
           "description": "key-value pairs. If present, Skaffold will build a Helm `values` file that overrides the original and use it to call Helm CLI (`--f` flag).",
-          "x-intellij-html-description": "key-value pairs. If present, Skaffold will build a Helm <code>values</code> file that overrides the original and use it to call Helm CLI (<code>--f</code> flag).\n",
+          "x-intellij-html-description": "<p>key-value pairs. If present, Skaffold will build a Helm <code>values</code> file that overrides the original and use it to call Helm CLI (<code>--f</code> flag).</p>\n",
           "default": "{}"
         },
         "packaged": {
           "$ref": "#/definitions/HelmPackaged",
           "description": "parameters for packaging helm chart (`helm package`).",
-          "x-intellij-html-description": "parameters for packaging helm chart (<code>helm package</code>).\n"
+          "x-intellij-html-description": "<p>parameters for packaging helm chart (<code>helm package</code>).</p>\n"
         },
         "recreatePods": {
           "type": "boolean",
           "description": "if `true`, Skaffold will send `--recreate-pods` flag to Helm CLI.",
-          "x-intellij-html-description": "if <code>true</code>, Skaffold will send <code>--recreate-pods</code> flag to Helm CLI.\n",
+          "x-intellij-html-description": "<p>if <code>true</code>, Skaffold will send <code>--recreate-pods</code> flag to Helm CLI.</p>\n",
           "default": "false"
         },
         "setValueTemplates": {
@@ -1024,7 +1024,7 @@
           },
           "type": "object",
           "description": "key-value pairs. If present, Skaffold will try to parse the value part of each key-value pair using environment variables in the system, then send `--set` flag to Helm CLI and append all parsed pairs after the flag.",
-          "x-intellij-html-description": "key-value pairs. If present, Skaffold will try to parse the value part of each key-value pair using environment variables in the system, then send <code>--set</code> flag to Helm CLI and append all parsed pairs after the flag.\n",
+          "x-intellij-html-description": "<p>key-value pairs. If present, Skaffold will try to parse the value part of each key-value pair using environment variables in the system, then send <code>--set</code> flag to Helm CLI and append all parsed pairs after the flag.</p>\n",
           "default": "{}"
         },
         "setValues": {
@@ -1033,13 +1033,13 @@
           },
           "type": "object",
           "description": "key-value pairs. If present, Skaffold will send `--set` flag to Helm CLI and append all pairs after the flag.",
-          "x-intellij-html-description": "key-value pairs. If present, Skaffold will send <code>--set</code> flag to Helm CLI and append all pairs after the flag.\n",
+          "x-intellij-html-description": "<p>key-value pairs. If present, Skaffold will send <code>--set</code> flag to Helm CLI and append all pairs after the flag.</p>\n",
           "default": "{}"
         },
         "skipBuildDependencies": {
           "type": "boolean",
           "description": "should build dependencies be skipped.",
-          "x-intellij-html-description": "should build dependencies be skipped.\n",
+          "x-intellij-html-description": "<p>should build dependencies be skipped.</p>\n",
           "default": "false"
         },
         "values": {
@@ -1048,7 +1048,7 @@
           },
           "type": "object",
           "description": "key-value pairs supplementing the Helm `values` file\".",
-          "x-intellij-html-description": "key-value pairs supplementing the Helm <code>values</code> file&quot;.\n",
+          "x-intellij-html-description": "<p>key-value pairs supplementing the Helm <code>values</code> file&quot;.</p>\n",
           "default": "{}"
         },
         "valuesFiles": {
@@ -1057,18 +1057,18 @@
           },
           "type": "array",
           "description": "paths to the Helm `values` files\".",
-          "x-intellij-html-description": "paths to the Helm <code>values</code> files&quot;.\n",
+          "x-intellij-html-description": "<p>paths to the Helm <code>values</code> files&quot;.</p>\n",
           "default": "[]"
         },
         "version": {
           "type": "string",
           "description": "version of the chart.",
-          "x-intellij-html-description": "version of the chart.\n"
+          "x-intellij-html-description": "<p>version of the chart.</p>\n"
         },
         "wait": {
           "type": "boolean",
           "description": "if `true`, Skaffold will send `--wait` flag to Helm CLI.",
-          "x-intellij-html-description": "if <code>true</code>, Skaffold will send <code>--wait</code> flag to Helm CLI.\n",
+          "x-intellij-html-description": "<p>if <code>true</code>, Skaffold will send <code>--wait</code> flag to Helm CLI.</p>\n",
           "default": "false"
         }
       },
@@ -1090,7 +1090,7 @@
       ],
       "additionalProperties": false,
       "description": "describes a helm release to be deployed.",
-      "x-intellij-html-description": "describes a helm release to be deployed.\n"
+      "x-intellij-html-description": "<p>describes a helm release to be deployed.</p>\n"
     },
     "JSONPatch": {
       "required": [
@@ -1100,18 +1100,18 @@
         "from": {
           "type": "string",
           "description": "source position in the yaml, used for `copy` or `move` operations.",
-          "x-intellij-html-description": "source position in the yaml, used for <code>copy</code> or <code>move</code> operations.\n"
+          "x-intellij-html-description": "<p>source position in the yaml, used for <code>copy</code> or <code>move</code> operations.</p>\n"
         },
         "op": {
           "type": "string",
           "description": "operation carried by the patch: `add`, `remove`, `replace`, `move`, `copy` or `test`.",
-          "x-intellij-html-description": "operation carried by the patch: <code>add</code>, <code>remove</code>, <code>replace</code>, <code>move</code>, <code>copy</code> or <code>test</code>.\n",
+          "x-intellij-html-description": "<p>operation carried by the patch: <code>add</code>, <code>remove</code>, <code>replace</code>, <code>move</code>, <code>copy</code> or <code>test</code>.</p>\n",
           "default": "replace"
         },
         "path": {
           "type": "string",
           "description": "position in the yaml where the operation takes place. For example, this targets the `dockerfile` of the first artifact built.",
-          "x-intellij-html-description": "position in the yaml where the operation takes place. For example, this targets the <code>dockerfile</code> of the first artifact built.\n",
+          "x-intellij-html-description": "<p>position in the yaml where the operation takes place. For example, this targets the <code>dockerfile</code> of the first artifact built.</p>\n",
           "examples": [
             "/build/artifacts/0/docker/dockerfile"
           ]
@@ -1119,7 +1119,7 @@
         "value": {
           "type": "object",
           "description": "value to apply. Can be any portion of yaml.",
-          "x-intellij-html-description": "value to apply. Can be any portion of yaml.\n"
+          "x-intellij-html-description": "<p>value to apply. Can be any portion of yaml.</p>\n"
         }
       },
       "preferredOrder": [
@@ -1130,7 +1130,7 @@
       ],
       "additionalProperties": false,
       "description": "patch to be applied by a profile.",
-      "x-intellij-html-description": "patch to be applied by a profile.\n"
+      "x-intellij-html-description": "<p>patch to be applied by a profile.</p>\n"
     },
     "JibGradleArtifact": {
       "properties": {
@@ -1140,7 +1140,7 @@
           },
           "type": "array",
           "description": "additional build flags passed to Gradle.",
-          "x-intellij-html-description": "additional build flags passed to Gradle.\n",
+          "x-intellij-html-description": "<p>additional build flags passed to Gradle.</p>\n",
           "default": "[]",
           "examples": [
             "[\"--no-build-cache\"]"
@@ -1149,7 +1149,7 @@
         "project": {
           "type": "string",
           "description": "selects which Gradle project to build.",
-          "x-intellij-html-description": "selects which Gradle project to build.\n"
+          "x-intellij-html-description": "<p>selects which Gradle project to build.</p>\n"
         }
       },
       "preferredOrder": [
@@ -1157,8 +1157,8 @@
         "args"
       ],
       "additionalProperties": false,
-      "description": "(alpha) builds images using the [Jib plugin for Gradle](https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin).",
-      "x-intellij-html-description": "(alpha) builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin\">Jib plugin for Gradle</a>.\n"
+      "description": "*alpha* builds images using the [Jib plugin for Gradle](https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin).",
+      "x-intellij-html-description": "<p><em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin\">Jib plugin for Gradle</a>.</p>\n"
     },
     "JibMavenArtifact": {
       "properties": {
@@ -1168,7 +1168,7 @@
           },
           "type": "array",
           "description": "additional build flags passed to Maven.",
-          "x-intellij-html-description": "additional build flags passed to Maven.\n",
+          "x-intellij-html-description": "<p>additional build flags passed to Maven.</p>\n",
           "default": "[]",
           "examples": [
             "[\"-x\", \"-DskipTests\"]"
@@ -1177,12 +1177,12 @@
         "module": {
           "type": "string",
           "description": "selects which Maven module to build, for a multi module project.",
-          "x-intellij-html-description": "selects which Maven module to build, for a multi module project.\n"
+          "x-intellij-html-description": "<p>selects which Maven module to build, for a multi module project.</p>\n"
         },
         "profile": {
           "type": "string",
           "description": "selects which Maven profile to activate.",
-          "x-intellij-html-description": "selects which Maven profile to activate.\n"
+          "x-intellij-html-description": "<p>selects which Maven profile to activate.</p>\n"
         }
       },
       "preferredOrder": [
@@ -1191,25 +1191,25 @@
         "args"
       ],
       "additionalProperties": false,
-      "description": "(alpha) builds images using the [Jib plugin for Maven](https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin).",
-      "x-intellij-html-description": "(alpha) builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin\">Jib plugin for Maven</a>.\n"
+      "description": "*alpha* builds images using the [Jib plugin for Maven](https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin).",
+      "x-intellij-html-description": "<p><em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin\">Jib plugin for Maven</a>.</p>\n"
     },
     "KanikoBuild": {
       "properties": {
         "buildContext": {
           "$ref": "#/definitions/KanikoBuildContext",
           "description": "defines where Kaniko gets the sources from.",
-          "x-intellij-html-description": "defines where Kaniko gets the sources from.\n"
+          "x-intellij-html-description": "<p>defines where Kaniko gets the sources from.</p>\n"
         },
         "cache": {
           "$ref": "#/definitions/KanikoCache",
           "description": "configures Kaniko caching. If a cache is specified, Kaniko will use a remote cache which will speed up builds.",
-          "x-intellij-html-description": "configures Kaniko caching. If a cache is specified, Kaniko will use a remote cache which will speed up builds.\n"
+          "x-intellij-html-description": "<p>configures Kaniko caching. If a cache is specified, Kaniko will use a remote cache which will speed up builds.</p>\n"
         },
         "dockerConfig": {
           "$ref": "#/definitions/DockerConfig",
           "description": "describes how to mount the local Docker configuration into the Kaniko pod.",
-          "x-intellij-html-description": "describes how to mount the local Docker configuration into the Kaniko pod.\n"
+          "x-intellij-html-description": "<p>describes how to mount the local Docker configuration into the Kaniko pod.</p>\n"
         },
         "flags": {
           "items": {
@@ -1217,34 +1217,34 @@
           },
           "type": "array",
           "description": "additional flags to be passed to Kaniko command line. See [Kaniko Additional Flags](https://github.com/GoogleContainerTools/kaniko#additional-flags).",
-          "x-intellij-html-description": "additional flags to be passed to Kaniko command line. See <a href=\"https://github.com/GoogleContainerTools/kaniko#additional-flags\">Kaniko Additional Flags</a>.\n",
+          "x-intellij-html-description": "<p>additional flags to be passed to Kaniko command line. See <a href=\"https://github.com/GoogleContainerTools/kaniko#additional-flags\">Kaniko Additional Flags</a>.</p>\n",
           "default": "[]"
         },
         "image": {
           "type": "string",
           "description": "Docker image used by the Kaniko pod. Defaults to the latest released version of `gcr.io/kaniko-project/executor`.",
-          "x-intellij-html-description": "Docker image used by the Kaniko pod. Defaults to the latest released version of <code>gcr.io/kaniko-project/executor</code>.\n"
+          "x-intellij-html-description": "<p>Docker image used by the Kaniko pod. Defaults to the latest released version of <code>gcr.io/kaniko-project/executor</code>.</p>\n"
         },
         "namespace": {
           "type": "string",
           "description": "Kubernetes namespace. Defaults to current namespace in Kubernetes configuration.",
-          "x-intellij-html-description": "Kubernetes namespace. Defaults to current namespace in Kubernetes configuration.\n"
+          "x-intellij-html-description": "<p>Kubernetes namespace. Defaults to current namespace in Kubernetes configuration.</p>\n"
         },
         "pullSecret": {
           "type": "string",
           "description": "path to the secret key file. See [Kaniko Documentation](https://github.com/GoogleContainerTools/kaniko#running-kaniko-in-a-kubernetes-cluster).",
-          "x-intellij-html-description": "path to the secret key file. See <a href=\"https://github.com/GoogleContainerTools/kaniko#running-kaniko-in-a-kubernetes-cluster\">Kaniko Documentation</a>.\n"
+          "x-intellij-html-description": "<p>path to the secret key file. See <a href=\"https://github.com/GoogleContainerTools/kaniko#running-kaniko-in-a-kubernetes-cluster\">Kaniko Documentation</a>.</p>\n"
         },
         "pullSecretName": {
           "type": "string",
           "description": "name of the Kubernetes secret for pulling the files from the build context and pushing the final image.",
-          "x-intellij-html-description": "name of the Kubernetes secret for pulling the files from the build context and pushing the final image.\n",
+          "x-intellij-html-description": "<p>name of the Kubernetes secret for pulling the files from the build context and pushing the final image.</p>\n",
           "default": "kaniko-secret"
         },
         "timeout": {
           "type": "string",
           "description": "amount of time (in seconds) that this build is allowed to run. Defaults to 20 minutes (`20m`).",
-          "x-intellij-html-description": "amount of time (in seconds) that this build is allowed to run. Defaults to 20 minutes (<code>20m</code>).\n"
+          "x-intellij-html-description": "<p>amount of time (in seconds) that this build is allowed to run. Defaults to 20 minutes (<code>20m</code>).</p>\n"
         }
       },
       "preferredOrder": [
@@ -1259,20 +1259,20 @@
         "dockerConfig"
       ],
       "additionalProperties": false,
-      "description": "(beta) describes how to do an on-cluster build using [Kaniko](https://github.com/GoogleContainerTools/kaniko).",
-      "x-intellij-html-description": "(beta) describes how to do an on-cluster build using <a href=\"https://github.com/GoogleContainerTools/kaniko\">Kaniko</a>.\n"
+      "description": "*beta* describes how to do an on-cluster build using [Kaniko](https://github.com/GoogleContainerTools/kaniko).",
+      "x-intellij-html-description": "<p><em>beta</em> describes how to do an on-cluster build using <a href=\"https://github.com/GoogleContainerTools/kaniko\">Kaniko</a>.</p>\n"
     },
     "KanikoBuildContext": {
       "properties": {
         "gcsBucket": {
           "type": "string",
           "description": "CGS bucket to which sources are uploaded by Skaffold. Kaniko will need access to that bucket to download the sources.",
-          "x-intellij-html-description": "CGS bucket to which sources are uploaded by Skaffold. Kaniko will need access to that bucket to download the sources.\n"
+          "x-intellij-html-description": "<p>CGS bucket to which sources are uploaded by Skaffold. Kaniko will need access to that bucket to download the sources.</p>\n"
         },
         "localDir": {
           "$ref": "#/definitions/LocalDir",
           "description": "configures how Kaniko mounts sources directly via an `emptyDir` volume.",
-          "x-intellij-html-description": "configures how Kaniko mounts sources directly via an <code>emptyDir</code> volume.\n"
+          "x-intellij-html-description": "<p>configures how Kaniko mounts sources directly via an <code>emptyDir</code> volume.</p>\n"
         }
       },
       "preferredOrder": [
@@ -1281,14 +1281,14 @@
       ],
       "additionalProperties": false,
       "description": "contains the different fields available to specify a Kaniko build context.",
-      "x-intellij-html-description": "contains the different fields available to specify a Kaniko build context.\n"
+      "x-intellij-html-description": "<p>contains the different fields available to specify a Kaniko build context.</p>\n"
     },
     "KanikoCache": {
       "properties": {
         "repo": {
           "type": "string",
           "description": "a remote repository to store cached layers. If none is specified, one will be inferred from the image name. See [Kaniko Caching](https://github.com/GoogleContainerTools/kaniko#caching).",
-          "x-intellij-html-description": "a remote repository to store cached layers. If none is specified, one will be inferred from the image name. See <a href=\"https://github.com/GoogleContainerTools/kaniko#caching\">Kaniko Caching</a>.\n"
+          "x-intellij-html-description": "<p>a remote repository to store cached layers. If none is specified, one will be inferred from the image name. See <a href=\"https://github.com/GoogleContainerTools/kaniko#caching\">Kaniko Caching</a>.</p>\n"
         }
       },
       "preferredOrder": [
@@ -1296,14 +1296,14 @@
       ],
       "additionalProperties": false,
       "description": "configures Kaniko caching. If a cache is specified, Kaniko will use a remote cache which will speed up builds.",
-      "x-intellij-html-description": "configures Kaniko caching. If a cache is specified, Kaniko will use a remote cache which will speed up builds.\n"
+      "x-intellij-html-description": "<p>configures Kaniko caching. If a cache is specified, Kaniko will use a remote cache which will speed up builds.</p>\n"
     },
     "KubectlDeploy": {
       "properties": {
         "flags": {
           "$ref": "#/definitions/KubectlFlags",
           "description": "additional flags passed to `kubectl`.",
-          "x-intellij-html-description": "additional flags passed to <code>kubectl</code>.\n"
+          "x-intellij-html-description": "<p>additional flags passed to <code>kubectl</code>.</p>\n"
         },
         "manifests": {
           "items": {
@@ -1311,7 +1311,7 @@
           },
           "type": "array",
           "description": "the Kubernetes yaml or json manifests.",
-          "x-intellij-html-description": "the Kubernetes yaml or json manifests.\n",
+          "x-intellij-html-description": "<p>the Kubernetes yaml or json manifests.</p>\n",
           "default": "[\"k8s/*.yaml\"]"
         },
         "remoteManifests": {
@@ -1320,7 +1320,7 @@
           },
           "type": "array",
           "description": "Kubernetes manifests in remote clusters.",
-          "x-intellij-html-description": "Kubernetes manifests in remote clusters.\n",
+          "x-intellij-html-description": "<p>Kubernetes manifests in remote clusters.</p>\n",
           "default": "[]"
         }
       },
@@ -1330,8 +1330,8 @@
         "flags"
       ],
       "additionalProperties": false,
-      "description": "(beta) uses a client side `kubectl apply` to deploy manifests. You'll need a `kubectl` CLI version installed that's compatible with your cluster.",
-      "x-intellij-html-description": "(beta) uses a client side <code>kubectl apply</code> to deploy manifests. You'll need a <code>kubectl</code> CLI version installed that's compatible with your cluster.\n"
+      "description": "*beta* uses a client side `kubectl apply` to deploy manifests. You'll need a `kubectl` CLI version installed that's compatible with your cluster.",
+      "x-intellij-html-description": "<p><em>beta</em> uses a client side <code>kubectl apply</code> to deploy manifests. You'll need a <code>kubectl</code> CLI version installed that's compatible with your cluster.</p>\n"
     },
     "KubectlFlags": {
       "properties": {
@@ -1341,7 +1341,7 @@
           },
           "type": "array",
           "description": "additional flags passed on creations (`kubectl apply`).",
-          "x-intellij-html-description": "additional flags passed on creations (<code>kubectl apply</code>).\n",
+          "x-intellij-html-description": "<p>additional flags passed on creations (<code>kubectl apply</code>).</p>\n",
           "default": "[]"
         },
         "delete": {
@@ -1350,7 +1350,7 @@
           },
           "type": "array",
           "description": "additional flags passed on deletions (`kubectl delete`).",
-          "x-intellij-html-description": "additional flags passed on deletions (<code>kubectl delete</code>).\n",
+          "x-intellij-html-description": "<p>additional flags passed on deletions (<code>kubectl delete</code>).</p>\n",
           "default": "[]"
         },
         "global": {
@@ -1359,7 +1359,7 @@
           },
           "type": "array",
           "description": "additional flags passed on every command.",
-          "x-intellij-html-description": "additional flags passed on every command.\n",
+          "x-intellij-html-description": "<p>additional flags passed on every command.</p>\n",
           "default": "[]"
         }
       },
@@ -1370,19 +1370,19 @@
       ],
       "additionalProperties": false,
       "description": "additional flags passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).",
-      "x-intellij-html-description": "additional flags passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).\n"
+      "x-intellij-html-description": "<p>additional flags passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).</p>\n"
     },
     "KustomizeDeploy": {
       "properties": {
         "flags": {
           "$ref": "#/definitions/KubectlFlags",
           "description": "additional flags passed to `kubectl`.",
-          "x-intellij-html-description": "additional flags passed to <code>kubectl</code>.\n"
+          "x-intellij-html-description": "<p>additional flags passed to <code>kubectl</code>.</p>\n"
         },
         "path": {
           "type": "string",
           "description": "path to Kustomization files.",
-          "x-intellij-html-description": "path to Kustomization files.\n",
+          "x-intellij-html-description": "<p>path to Kustomization files.</p>\n",
           "default": "."
         }
       },
@@ -1391,26 +1391,26 @@
         "flags"
       ],
       "additionalProperties": false,
-      "description": "(beta) uses the `kustomize` CLI to \"patch\" a deployment for a target environment.",
-      "x-intellij-html-description": "(beta) uses the <code>kustomize</code> CLI to &quot;patch&quot; a deployment for a target environment.\n"
+      "description": "*beta* uses the `kustomize` CLI to \"patch\" a deployment for a target environment.",
+      "x-intellij-html-description": "<p><em>beta</em> uses the <code>kustomize</code> CLI to &quot;patch&quot; a deployment for a target environment.</p>\n"
     },
     "LocalBuild": {
       "properties": {
         "push": {
           "type": "boolean",
           "description": "should images be pushed to a registry. If not specified, images are pushed only if the current Kubernetes context connects to a remote cluster.",
-          "x-intellij-html-description": "should images be pushed to a registry. If not specified, images are pushed only if the current Kubernetes context connects to a remote cluster.\n"
+          "x-intellij-html-description": "<p>should images be pushed to a registry. If not specified, images are pushed only if the current Kubernetes context connects to a remote cluster.</p>\n"
         },
         "useBuildkit": {
           "type": "boolean",
           "description": "use BuildKit to build Docker images.",
-          "x-intellij-html-description": "use BuildKit to build Docker images.\n",
+          "x-intellij-html-description": "<p>use BuildKit to build Docker images.</p>\n",
           "default": "false"
         },
         "useDockerCLI": {
           "type": "boolean",
           "description": "use `docker` command-line interface instead of Docker Engine APIs.",
-          "x-intellij-html-description": "use <code>docker</code> command-line interface instead of Docker Engine APIs.\n",
+          "x-intellij-html-description": "<p>use <code>docker</code> command-line interface instead of Docker Engine APIs.</p>\n",
           "default": "false"
         }
       },
@@ -1420,12 +1420,12 @@
         "useBuildkit"
       ],
       "additionalProperties": false,
-      "description": "(beta) describes how to do a build on the local docker daemon and optionally push to a repository.",
-      "x-intellij-html-description": "(beta) describes how to do a build on the local docker daemon and optionally push to a repository.\n"
+      "description": "*beta* describes how to do a build on the local docker daemon and optionally push to a repository.",
+      "x-intellij-html-description": "<p><em>beta</em> describes how to do a build on the local docker daemon and optionally push to a repository.</p>\n"
     },
     "LocalDir": {
       "description": "configures how Kaniko mounts sources directly via an `emptyDir` volume.",
-      "x-intellij-html-description": "configures how Kaniko mounts sources directly via an <code>emptyDir</code> volume.\n"
+      "x-intellij-html-description": "<p>configures how Kaniko mounts sources directly via an <code>emptyDir</code> volume.</p>\n"
     },
     "Profile": {
       "required": [
@@ -1438,22 +1438,22 @@
           },
           "type": "array",
           "description": "criteria by which a profile can be auto-activated.",
-          "x-intellij-html-description": "criteria by which a profile can be auto-activated.\n"
+          "x-intellij-html-description": "<p>criteria by which a profile can be auto-activated.</p>\n"
         },
         "build": {
           "$ref": "#/definitions/BuildConfig",
           "description": "replaces the main `build` configuration.",
-          "x-intellij-html-description": "replaces the main <code>build</code> configuration.\n"
+          "x-intellij-html-description": "<p>replaces the main <code>build</code> configuration.</p>\n"
         },
         "deploy": {
           "$ref": "#/definitions/DeployConfig",
           "description": "replaces the main `deploy` configuration.",
-          "x-intellij-html-description": "replaces the main <code>deploy</code> configuration.\n"
+          "x-intellij-html-description": "<p>replaces the main <code>deploy</code> configuration.</p>\n"
         },
         "name": {
           "type": "string",
           "description": "a unique profile name.",
-          "x-intellij-html-description": "a unique profile name.\n",
+          "x-intellij-html-description": "<p>a unique profile name.</p>\n",
           "examples": [
             "profile-prod"
           ]
@@ -1464,7 +1464,7 @@
           },
           "type": "array",
           "description": "a list of patches applied to the configuration. Patches use the JSON patch notation.",
-          "x-intellij-html-description": "a list of patches applied to the configuration. Patches use the JSON patch notation.\n"
+          "x-intellij-html-description": "<p>a list of patches applied to the configuration. Patches use the JSON patch notation.</p>\n"
         },
         "test": {
           "items": {
@@ -1472,7 +1472,7 @@
           },
           "type": "array",
           "description": "replaces the main `test` configuration.",
-          "x-intellij-html-description": "replaces the main <code>test</code> configuration.\n"
+          "x-intellij-html-description": "<p>replaces the main <code>test</code> configuration.</p>\n"
         }
       },
       "preferredOrder": [
@@ -1484,34 +1484,34 @@
         "activation"
       ],
       "additionalProperties": false,
-      "description": "(beta) profiles are used to override any `build`, `test` or `deploy` configuration.",
-      "x-intellij-html-description": "(beta) profiles are used to override any <code>build</code>, <code>test</code> or <code>deploy</code> configuration.\n"
+      "description": "*beta* profiles are used to override any `build`, `test` or `deploy` configuration.",
+      "x-intellij-html-description": "<p><em>beta</em> profiles are used to override any <code>build</code>, <code>test</code> or <code>deploy</code> configuration.</p>\n"
     },
     "ShaTagger": {
-      "description": "(beta) tags images with their sha256 digest.",
-      "x-intellij-html-description": "(beta) tags images with their sha256 digest.\n"
+      "description": "*beta* tags images with their sha256 digest.",
+      "x-intellij-html-description": "<p><em>beta</em> tags images with their sha256 digest.</p>\n"
     },
     "SkaffoldPipeline": {
       "properties": {
         "apiVersion": {
           "type": "string",
           "description": "version of the configuration.",
-          "x-intellij-html-description": "version of the configuration.\n"
+          "x-intellij-html-description": "<p>version of the configuration.</p>\n"
         },
         "build": {
           "$ref": "#/definitions/BuildConfig",
           "description": "describes how images are built.",
-          "x-intellij-html-description": "describes how images are built.\n"
+          "x-intellij-html-description": "<p>describes how images are built.</p>\n"
         },
         "deploy": {
           "$ref": "#/definitions/DeployConfig",
           "description": "describes how images are deployed.",
-          "x-intellij-html-description": "describes how images are deployed.\n"
+          "x-intellij-html-description": "<p>describes how images are deployed.</p>\n"
         },
         "kind": {
           "type": "string",
           "description": "always `Config`.",
-          "x-intellij-html-description": "always <code>Config</code>.\n",
+          "x-intellij-html-description": "<p>always <code>Config</code>.</p>\n",
           "default": "Config"
         },
         "profiles": {
@@ -1519,8 +1519,8 @@
             "$ref": "#/definitions/Profile"
           },
           "type": "array",
-          "description": "(beta) can override be used to `build`, `test` or `deploy` configuration.",
-          "x-intellij-html-description": "(beta) can override be used to <code>build</code>, <code>test</code> or <code>deploy</code> configuration.\n"
+          "description": "*beta* can override be used to `build`, `test` or `deploy` configuration.",
+          "x-intellij-html-description": "<p><em>beta</em> can override be used to <code>build</code>, <code>test</code> or <code>deploy</code> configuration.</p>\n"
         },
         "test": {
           "items": {
@@ -1528,7 +1528,7 @@
           },
           "type": "array",
           "description": "describes how images are tested.",
-          "x-intellij-html-description": "describes how images are tested.\n"
+          "x-intellij-html-description": "<p>describes how images are tested.</p>\n"
         }
       },
       "preferredOrder": [
@@ -1541,29 +1541,29 @@
       ],
       "additionalProperties": false,
       "description": "describes a Skaffold pipeline.",
-      "x-intellij-html-description": "describes a Skaffold pipeline.\n"
+      "x-intellij-html-description": "<p>describes a Skaffold pipeline.</p>\n"
     },
     "TagPolicy": {
       "properties": {
         "dateTime": {
           "$ref": "#/definitions/DateTimeTagger",
-          "description": "(beta) tags images with the build timestamp.",
-          "x-intellij-html-description": "(beta) tags images with the build timestamp.\n"
+          "description": "*beta* tags images with the build timestamp.",
+          "x-intellij-html-description": "<p><em>beta</em> tags images with the build timestamp.</p>\n"
         },
         "envTemplate": {
           "$ref": "#/definitions/EnvTemplateTagger",
-          "description": "(beta) tags images with a configurable template string.",
-          "x-intellij-html-description": "(beta) tags images with a configurable template string.\n"
+          "description": "*beta* tags images with a configurable template string.",
+          "x-intellij-html-description": "<p><em>beta</em> tags images with a configurable template string.</p>\n"
         },
         "gitCommit": {
           "$ref": "#/definitions/GitTagger",
-          "description": "(beta) tags images with the git tag or commit of the artifact's workspace.",
-          "x-intellij-html-description": "(beta) tags images with the git tag or commit of the artifact's workspace.\n"
+          "description": "*beta* tags images with the git tag or commit of the artifact's workspace.",
+          "x-intellij-html-description": "<p><em>beta</em> tags images with the git tag or commit of the artifact's workspace.</p>\n"
         },
         "sha256": {
           "$ref": "#/definitions/ShaTagger",
-          "description": "(beta) tags images with their sha256 digest.",
-          "x-intellij-html-description": "(beta) tags images with their sha256 digest.\n"
+          "description": "*beta* tags images with their sha256 digest.",
+          "x-intellij-html-description": "<p><em>beta</em> tags images with their sha256 digest.</p>\n"
         }
       },
       "preferredOrder": [
@@ -1574,7 +1574,7 @@
       ],
       "additionalProperties": false,
       "description": "contains all the configuration for the tagging step.",
-      "x-intellij-html-description": "contains all the configuration for the tagging step.\n"
+      "x-intellij-html-description": "<p>contains all the configuration for the tagging step.</p>\n"
     },
     "TestCase": {
       "required": [
@@ -1584,7 +1584,7 @@
         "image": {
           "type": "string",
           "description": "artifact on which to run those tests.",
-          "x-intellij-html-description": "artifact on which to run those tests.\n",
+          "x-intellij-html-description": "<p>artifact on which to run those tests.</p>\n",
           "examples": [
             "gcr.io/k8s-skaffold/example"
           ]
@@ -1595,7 +1595,7 @@
           },
           "type": "array",
           "description": "the [Container Structure Tests](https://github.com/GoogleContainerTools/container-structure-test) to run on that artifact.",
-          "x-intellij-html-description": "the <a href=\"https://github.com/GoogleContainerTools/container-structure-test\">Container Structure Tests</a> to run on that artifact.\n",
+          "x-intellij-html-description": "<p>the <a href=\"https://github.com/GoogleContainerTools/container-structure-test\">Container Structure Tests</a> to run on that artifact.</p>\n",
           "default": "[]",
           "examples": [
             "[\"./test/*\"]"
@@ -1608,7 +1608,7 @@
       ],
       "additionalProperties": false,
       "description": "a list of structure tests to run on images that Skaffold builds.",
-      "x-intellij-html-description": "a list of structure tests to run on images that Skaffold builds.\n"
+      "x-intellij-html-description": "<p>a list of structure tests to run on images that Skaffold builds.</p>\n"
     }
   }
 }
diff --git a/hack/schemas/main.go b/hack/schemas/main.go
index e146266237b..136c393dec8 100644
--- a/hack/schemas/main.go
+++ b/hack/schemas/main.go
@@ -232,9 +232,7 @@ func (g *schemaGenerator) newDefinition(name string, t ast.Expr, comment string)
 	}
 
 	// Remove type prefix
-	if m := regexp.MustCompile("^" + name + " ((is (the )?)|(are (the )?)|(lists ))?(.*)").FindStringSubmatch(description); m != nil {
-		description = m[7]
-	}
+	description = regexp.MustCompile("^"+name+" (\\*.*\\* )?((is (the )?)|(are (the )?)|(lists ))?").ReplaceAllString(description, "$1")
 
 	if g.strict && name != "" {
 		if description == "" {
@@ -248,7 +246,7 @@ func (g *schemaGenerator) newDefinition(name string, t ast.Expr, comment string)
 
 	// Convert to HTML
 	html := string(blackfriday.Run([]byte(description), blackfriday.WithNoExtensions()))
-	def.HTMLDescription = pTags.ReplaceAllString(html, "")
+	def.HTMLDescription = html
 
 	return def
 }
diff --git a/pkg/skaffold/schema/latest/config.go b/pkg/skaffold/schema/latest/config.go
index bfc3277999f..5ddfc386021 100644
--- a/pkg/skaffold/schema/latest/config.go
+++ b/pkg/skaffold/schema/latest/config.go
@@ -45,7 +45,7 @@ type SkaffoldPipeline struct {
 	// Deploy describes how images are deployed.
 	Deploy DeployConfig `yaml:"deploy,omitempty"`
 
-	// Profiles (beta) can override be used to `build`, `test` or `deploy` configuration.
+	// Profiles *beta* can override be used to `build`, `test` or `deploy` configuration.
 	Profiles []Profile `yaml:"profiles,omitempty"`
 }
 
@@ -58,7 +58,7 @@ type BuildConfig struct {
 	// Artifacts lists the images you're going to be building.
 	Artifacts []*Artifact `yaml:"artifacts,omitempty"`
 
-	// TagPolicy (beta) determines how images are tagged.
+	// TagPolicy *beta* determines how images are tagged.
 	// A few strategies are provided here, although you most likely won't need to care!
 	// If not specified, it defaults to `gitCommit: {}`.
 	TagPolicy TagPolicy `yaml:"tagPolicy,omitempty"`
@@ -96,26 +96,26 @@ type BuilderPlugin struct {
 
 // TagPolicy contains all the configuration for the tagging step.
 type TagPolicy struct {
-	// GitTagger (beta) tags images with the git tag or commit of the artifact's workspace.
+	// GitTagger *beta* tags images with the git tag or commit of the artifact's workspace.
 	GitTagger *GitTagger `yaml:"gitCommit,omitempty" yamltags:"oneOf=tag"`
 
-	// ShaTagger (beta) tags images with their sha256 digest.
+	// ShaTagger *beta* tags images with their sha256 digest.
 	ShaTagger *ShaTagger `yaml:"sha256,omitempty" yamltags:"oneOf=tag"`
 
-	// EnvTemplateTagger (beta) tags images with a configurable template string.
+	// EnvTemplateTagger *beta* tags images with a configurable template string.
 	EnvTemplateTagger *EnvTemplateTagger `yaml:"envTemplate,omitempty" yamltags:"oneOf=tag"`
 
-	// DateTimeTagger (beta) tags images with the build timestamp.
+	// DateTimeTagger *beta* tags images with the build timestamp.
 	DateTimeTagger *DateTimeTagger `yaml:"dateTime,omitempty" yamltags:"oneOf=tag"`
 }
 
-// ShaTagger (beta) tags images with their sha256 digest.
+// ShaTagger *beta* tags images with their sha256 digest.
 type ShaTagger struct{}
 
-// GitTagger (beta) tags images with the git tag or commit of the artifact's workspace.
+// GitTagger *beta* tags images with the git tag or commit of the artifact's workspace.
 type GitTagger struct{}
 
-// EnvTemplateTagger (beta) tags images with a configurable template string.
+// EnvTemplateTagger *beta* tags images with a configurable template string.
 type EnvTemplateTagger struct {
 	// Template used to produce the image name and tag.
 	// See golang [text/template](https://golang.org/pkg/text/template/).
@@ -126,7 +126,7 @@ type EnvTemplateTagger struct {
 	Template string `yaml:"template,omitempty" yamltags:"required"`
 }
 
-// DateTimeTagger (beta) tags images with the build timestamp.
+// DateTimeTagger *beta* tags images with the build timestamp.
 type DateTimeTagger struct {
 	// Format formats the date and time.
 	// See [#Time.Format](https://golang.org/pkg/time/#Time.Format).
@@ -142,20 +142,20 @@ type DateTimeTagger struct {
 // BuildType contains the specific implementation and parameters needed
 // for the build step. Only one field should be populated.
 type BuildType struct {
-	// LocalBuild (beta) describes how to do a build on the local docker daemon
+	// LocalBuild *beta* describes how to do a build on the local docker daemon
 	// and optionally push to a repository.
 	LocalBuild *LocalBuild `yaml:"local,omitempty" yamltags:"oneOf=build"`
 
-	// GoogleCloudBuild (beta) describes how to do a remote build on
+	// GoogleCloudBuild *beta* describes how to do a remote build on
 	// [Google Cloud Build](https://cloud.google.com/cloud-build/).
 	GoogleCloudBuild *GoogleCloudBuild `yaml:"googleCloudBuild,omitempty" yamltags:"oneOf=build"`
 
-	// KanikoBuild (beta) describes how to do an on-cluster build using
+	// KanikoBuild *beta* describes how to do an on-cluster build using
 	// [Kaniko](https://github.com/GoogleContainerTools/kaniko).
 	KanikoBuild *KanikoBuild `yaml:"kaniko,omitempty" yamltags:"oneOf=build"`
 }
 
-// LocalBuild (beta) describes how to do a build on the local docker daemon
+// LocalBuild *beta* describes how to do a build on the local docker daemon
 // and optionally push to a repository.
 type LocalBuild struct {
 	// Push should images be pushed to a registry.
@@ -170,7 +170,7 @@ type LocalBuild struct {
 	UseBuildkit bool `yaml:"useBuildkit,omitempty"`
 }
 
-// GoogleCloudBuild (beta) describes how to do a remote build on
+// GoogleCloudBuild *beta* describes how to do a remote build on
 // [Google Cloud Build](https://cloud.google.com/cloud-build/docs/).
 // Docker and Jib artifacts can be built on Cloud Build. The `projectId` needs
 // to be provided and the currently logged in user should be given permissions to trigger
@@ -232,7 +232,7 @@ type KanikoCache struct {
 	Repo string `yaml:"repo,omitempty"`
 }
 
-// KanikoBuild (beta) describes how to do an on-cluster build using
+// KanikoBuild *beta* describes how to do an on-cluster build using
 // [Kaniko](https://github.com/GoogleContainerTools/kaniko).
 type KanikoBuild struct {
 	// BuildContext defines where Kaniko gets the sources from.
@@ -301,18 +301,18 @@ type DeployConfig struct {
 // DeployType contains the specific implementation and parameters needed
 // for the deploy step. Only one field should be populated.
 type DeployType struct {
-	// HelmDeploy (beta) uses the `helm` CLI to apply the charts to the cluster.
+	// HelmDeploy *beta* uses the `helm` CLI to apply the charts to the cluster.
 	HelmDeploy *HelmDeploy `yaml:"helm,omitempty" yamltags:"oneOf=deploy"`
 
-	// KubectlDeploy (beta) uses a client side `kubectl apply` to deploy manifests.
+	// KubectlDeploy *beta* uses a client side `kubectl apply` to deploy manifests.
 	// You'll need a `kubectl` CLI version installed that's compatible with your cluster.
 	KubectlDeploy *KubectlDeploy `yaml:"kubectl,omitempty" yamltags:"oneOf=deploy"`
 
-	// KustomizeDeploy (beta) uses the `kustomize` CLI to "patch" a deployment for a target environment.
+	// KustomizeDeploy *beta* uses the `kustomize` CLI to "patch" a deployment for a target environment.
 	KustomizeDeploy *KustomizeDeploy `yaml:"kustomize,omitempty" yamltags:"oneOf=deploy"`
 }
 
-// KubectlDeploy (beta) uses a client side `kubectl apply` to deploy manifests.
+// KubectlDeploy *beta* uses a client side `kubectl apply` to deploy manifests.
 // You'll need a `kubectl` CLI version installed that's compatible with your cluster.
 type KubectlDeploy struct {
 	// Manifests lists the Kubernetes yaml or json manifests.
@@ -340,7 +340,7 @@ type KubectlFlags struct {
 	Delete []string `yaml:"delete,omitempty"`
 }
 
-// HelmDeploy (beta) uses the `helm` CLI to apply the charts to the cluster.
+// HelmDeploy *beta* uses the `helm` CLI to apply the charts to the cluster.
 type HelmDeploy struct {
 	// Releases is a list of Helm releases.
 	Releases []HelmRelease `yaml:"releases,omitempty" yamltags:"required"`
@@ -363,7 +363,7 @@ type HelmDeployFlags struct {
 	Upgrade []string `yaml:"upgrade,omitempty"`
 }
 
-// KustomizeDeploy (beta) uses the `kustomize` CLI to "patch" a deployment for a target environment.
+// KustomizeDeploy *beta* uses the `kustomize` CLI to "patch" a deployment for a target environment.
 type KustomizeDeploy struct {
 	// KustomizePath is the path to Kustomization files.
 	// Defaults to `.`.
@@ -466,11 +466,11 @@ type Artifact struct {
 	// For example: `gcr.io/k8s-skaffold/example`.
 	ImageName string `yaml:"image,omitempty" yamltags:"required"`
 
-	// Workspace is the directory where the artifact's sources are to be found.
+	// Workspace is the directory containing the artifact's sources.
 	// Defaults to `.`.
 	Workspace string `yaml:"context,omitempty"`
 
-	// Sync (alpha) lists local files that can be synced to remote pods instead
+	// Sync *alpha* lists local files synced to pods instead
 	// of triggering an image build when modified.
 	// This is a mapping of local files to sync to remote folders.
 	// For example: `{"*.py": ".", "css/**/*.css": "app/css"}`.
@@ -485,7 +485,7 @@ type Artifact struct {
 	BuilderPlugin *BuilderPlugin `yaml:"plugin,omitempty"`
 }
 
-// Profile (beta) profiles are used to override any `build`, `test` or `deploy` configuration.
+// Profile *beta* profiles are used to override any `build`, `test` or `deploy` configuration.
 type Profile struct {
 	// Name is a unique profile name.
 	// For example: `profile-prod`.
@@ -544,23 +544,23 @@ type Activation struct {
 
 // ArtifactType describes how to build an artifact.
 type ArtifactType struct {
-	// DockerArtifact (beta) describes an artifact built from a Dockerfile.
+	// DockerArtifact *beta* describes an artifact built from a Dockerfile.
 	DockerArtifact *DockerArtifact `yaml:"docker,omitempty" yamltags:"oneOf=artifact"`
 
-	// BazelArtifact (beta) requires bazel CLI to be installed and the sources to
+	// BazelArtifact *beta* requires bazel CLI to be installed and the sources to
 	// contain [Bazel](https://bazel.build/) configuration files.
 	BazelArtifact *BazelArtifact `yaml:"bazel,omitempty" yamltags:"oneOf=artifact"`
 
-	// JibMavenArtifact (alpha) builds images using the
+	// JibMavenArtifact *alpha* builds images using the
 	// [Jib plugin for Maven](https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin).
 	JibMavenArtifact *JibMavenArtifact `yaml:"jibMaven,omitempty" yamltags:"oneOf=artifact"`
 
-	// JibGradleArtifact (alpha) builds images using the
+	// JibGradleArtifact *alpha* builds images using the
 	// [Jib plugin for Gradle](https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin).
 	JibGradleArtifact *JibGradleArtifact `yaml:"jibGradle,omitempty" yamltags:"oneOf=artifact"`
 }
 
-// DockerArtifact (beta) describes an artifact built from a Dockerfile,
+// DockerArtifact *beta* describes an artifact built from a Dockerfile,
 // usually using `docker build`.
 type DockerArtifact struct {
 	// DockerfilePath locates the Dockerfile relative to workspace.
@@ -574,12 +574,12 @@ type DockerArtifact struct {
 	// For example: `{"key1": "value1", "key2": "value2"}`.
 	BuildArgs map[string]*string `yaml:"buildArgs,omitempty"`
 
-	// CacheFrom lists the Docker images to consider as cache sources.
+	// CacheFrom lists the Docker images used as cache sources.
 	// For example: `["golang:1.10.1-alpine3.7", "alpine:3.7"]`.
 	CacheFrom []string `yaml:"cacheFrom,omitempty"`
 }
 
-// BazelArtifact (beta) describes an artifact built with [Bazel](https://bazel.build/).
+// BazelArtifact *beta* describes an artifact built with [Bazel](https://bazel.build/).
 type BazelArtifact struct {
 	// BuildTarget is the `bazel build` target to run.
 	// For example: `//:skaffold_example.tar`.
@@ -590,7 +590,7 @@ type BazelArtifact struct {
 	BuildArgs []string `yaml:"args,omitempty"`
 }
 
-// JibMavenArtifact (alpha) builds images using the
+// JibMavenArtifact *alpha* builds images using the
 // [Jib plugin for Maven](https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin).
 type JibMavenArtifact struct {
 	// Module selects which Maven module to build, for a multi module project.
@@ -604,7 +604,7 @@ type JibMavenArtifact struct {
 	Flags []string `yaml:"args,omitempty"`
 }
 
-// JibGradleArtifact (alpha) builds images using the
+// JibGradleArtifact *alpha* builds images using the
 // [Jib plugin for Gradle](https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin).
 type JibGradleArtifact struct {
 	// Project selects which Gradle project to build.
diff --git a/pkg/skaffold/schema/v1beta5/config.go b/pkg/skaffold/schema/v1beta5/config.go
index 780eb905e45..67644bc8bc2 100644
--- a/pkg/skaffold/schema/v1beta5/config.go
+++ b/pkg/skaffold/schema/v1beta5/config.go
@@ -44,7 +44,7 @@ type SkaffoldPipeline struct {
 	// Deploy describes how images are deployed.
 	Deploy DeployConfig `yaml:"deploy,omitempty"`
 
-	// Profiles (beta) can override be used to `build`, `test` or `deploy` configuration.
+	// Profiles *beta* can override be used to `build`, `test` or `deploy` configuration.
 	Profiles []Profile `yaml:"profiles,omitempty"`
 }
 
@@ -57,7 +57,7 @@ type BuildConfig struct {
 	// Artifacts lists the images you're going to be building.
 	Artifacts []*Artifact `yaml:"artifacts,omitempty"`
 
-	// TagPolicy (beta) determines how images are tagged.
+	// TagPolicy *beta* determines how images are tagged.
 	// A few strategies are provided here, although you most likely won't need to care!
 	// If not specified, it defaults to `gitCommit: {}`.
 	TagPolicy TagPolicy `yaml:"tagPolicy,omitempty"`
@@ -94,26 +94,26 @@ type BuilderPlugin struct {
 
 // TagPolicy contains all the configuration for the tagging step.
 type TagPolicy struct {
-	// GitTagger (beta) tags images with the git tag or commit of the artifact's workspace.
+	// GitTagger *beta* tags images with the git tag or commit of the artifact's workspace.
 	GitTagger *GitTagger `yaml:"gitCommit,omitempty" yamltags:"oneOf=tag"`
 
-	// ShaTagger (beta) tags images with their sha256 digest.
+	// ShaTagger *beta* tags images with their sha256 digest.
 	ShaTagger *ShaTagger `yaml:"sha256,omitempty" yamltags:"oneOf=tag"`
 
-	// EnvTemplateTagger (beta) tags images with a configurable template string.
+	// EnvTemplateTagger *beta* tags images with a configurable template string.
 	EnvTemplateTagger *EnvTemplateTagger `yaml:"envTemplate,omitempty" yamltags:"oneOf=tag"`
 
-	// DateTimeTagger (beta) tags images with the build timestamp.
+	// DateTimeTagger *beta* tags images with the build timestamp.
 	DateTimeTagger *DateTimeTagger `yaml:"dateTime,omitempty" yamltags:"oneOf=tag"`
 }
 
-// ShaTagger (beta) tags images with their sha256 digest.
+// ShaTagger *beta* tags images with their sha256 digest.
 type ShaTagger struct{}
 
-// GitTagger (beta) tags images with the git tag or commit of the artifact's workspace.
+// GitTagger *beta* tags images with the git tag or commit of the artifact's workspace.
 type GitTagger struct{}
 
-// EnvTemplateTagger (beta) tags images with a configurable template string.
+// EnvTemplateTagger *beta* tags images with a configurable template string.
 type EnvTemplateTagger struct {
 	// Template used to produce the image name and tag.
 	// See golang [text/template](https://golang.org/pkg/text/template/).
@@ -124,7 +124,7 @@ type EnvTemplateTagger struct {
 	Template string `yaml:"template,omitempty" yamltags:"required"`
 }
 
-// DateTimeTagger (beta) tags images with the build timestamp.
+// DateTimeTagger *beta* tags images with the build timestamp.
 type DateTimeTagger struct {
 	// Format formats the date and time.
 	// See [#Time.Format](https://golang.org/pkg/time/#Time.Format).
@@ -140,20 +140,20 @@ type DateTimeTagger struct {
 // BuildType contains the specific implementation and parameters needed
 // for the build step. Only one field should be populated.
 type BuildType struct {
-	// LocalBuild (beta) describes how to do a build on the local docker daemon
+	// LocalBuild *beta* describes how to do a build on the local docker daemon
 	// and optionally push to a repository.
 	LocalBuild *LocalBuild `yaml:"local,omitempty" yamltags:"oneOf=build"`
 
-	// GoogleCloudBuild (beta) describes how to do a remote build on
+	// GoogleCloudBuild *beta* describes how to do a remote build on
 	// [Google Cloud Build](https://cloud.google.com/cloud-build/).
 	GoogleCloudBuild *GoogleCloudBuild `yaml:"googleCloudBuild,omitempty" yamltags:"oneOf=build"`
 
-	// KanikoBuild (beta) describes how to do an on-cluster build using
+	// KanikoBuild *beta* describes how to do an on-cluster build using
 	// [Kaniko](https://github.com/GoogleContainerTools/kaniko).
 	KanikoBuild *KanikoBuild `yaml:"kaniko,omitempty" yamltags:"oneOf=build"`
 }
 
-// LocalBuild (beta) describes how to do a build on the local docker daemon
+// LocalBuild *beta* describes how to do a build on the local docker daemon
 // and optionally push to a repository.
 type LocalBuild struct {
 	// Push should images be pushed to a registry.
@@ -168,7 +168,7 @@ type LocalBuild struct {
 	UseBuildkit bool `yaml:"useBuildkit,omitempty"`
 }
 
-// GoogleCloudBuild (beta) describes how to do a remote build on
+// GoogleCloudBuild *beta* describes how to do a remote build on
 // [Google Cloud Build](https://cloud.google.com/cloud-build/docs/).
 // Docker and Jib artifacts can be built on Cloud Build. The `projectId` needs
 // to be provided and the currently logged in user should be given permissions to trigger
@@ -230,7 +230,7 @@ type KanikoCache struct {
 	Repo string `yaml:"repo,omitempty"`
 }
 
-// KanikoBuild (beta) describes how to do an on-cluster build using
+// KanikoBuild *beta* describes how to do an on-cluster build using
 // [Kaniko](https://github.com/GoogleContainerTools/kaniko).
 type KanikoBuild struct {
 	// BuildContext defines where Kaniko gets the sources from.
@@ -299,18 +299,18 @@ type DeployConfig struct {
 // DeployType contains the specific implementation and parameters needed
 // for the deploy step. Only one field should be populated.
 type DeployType struct {
-	// HelmDeploy (beta) uses the `helm` CLI to apply the charts to the cluster.
+	// HelmDeploy *beta* uses the `helm` CLI to apply the charts to the cluster.
 	HelmDeploy *HelmDeploy `yaml:"helm,omitempty" yamltags:"oneOf=deploy"`
 
-	// KubectlDeploy (beta) uses a client side `kubectl apply` to deploy manifests.
+	// KubectlDeploy *beta* uses a client side `kubectl apply` to deploy manifests.
 	// You'll need a `kubectl` CLI version installed that's compatible with your cluster.
 	KubectlDeploy *KubectlDeploy `yaml:"kubectl,omitempty" yamltags:"oneOf=deploy"`
 
-	// KustomizeDeploy (beta) uses the `kustomize` CLI to "patch" a deployment for a target environment.
+	// KustomizeDeploy *beta* uses the `kustomize` CLI to "patch" a deployment for a target environment.
 	KustomizeDeploy *KustomizeDeploy `yaml:"kustomize,omitempty" yamltags:"oneOf=deploy"`
 }
 
-// KubectlDeploy (beta) uses a client side `kubectl apply` to deploy manifests.
+// KubectlDeploy *beta* uses a client side `kubectl apply` to deploy manifests.
 // You'll need a `kubectl` CLI version installed that's compatible with your cluster.
 type KubectlDeploy struct {
 	// Manifests lists the Kubernetes yaml or json manifests.
@@ -338,13 +338,13 @@ type KubectlFlags struct {
 	Delete []string `yaml:"delete,omitempty"`
 }
 
-// HelmDeploy (beta) uses the `helm` CLI to apply the charts to the cluster.
+// HelmDeploy *beta* uses the `helm` CLI to apply the charts to the cluster.
 type HelmDeploy struct {
 	// Releases is a list of Helm releases.
 	Releases []HelmRelease `yaml:"releases,omitempty" yamltags:"required"`
 }
 
-// KustomizeDeploy (beta) uses the `kustomize` CLI to "patch" a deployment for a target environment.
+// KustomizeDeploy *beta* uses the `kustomize` CLI to "patch" a deployment for a target environment.
 type KustomizeDeploy struct {
 	// KustomizePath is the path to Kustomization files.
 	// Defaults to `.`.
@@ -449,7 +449,7 @@ type Artifact struct {
 	// Defaults to `.`.
 	Workspace string `yaml:"context,omitempty"`
 
-	// Sync (alpha) lists local files that can be synced to remote pods instead
+	// Sync *alpha* lists local files that can be synced to remote pods instead
 	// of triggering an image build when modified.
 	// This is a mapping of local files to sync to remote folders.
 	// For example: `{"*.py": ".", "css/**/*.css": "app/css"}`.
@@ -461,7 +461,7 @@ type Artifact struct {
 	BuilderPlugin *BuilderPlugin `yaml:"plugin,omitempty"`
 }
 
-// Profile (beta) profiles are used to override any `build`, `test` or `deploy` configuration.
+// Profile *beta* profiles are used to override any `build`, `test` or `deploy` configuration.
 type Profile struct {
 	// Name is a unique profile name.
 	// For example: `profile-prod`.
@@ -519,23 +519,23 @@ type Activation struct {
 }
 
 type ArtifactType struct {
-	// DockerArtifact (beta) describes an artifact built from a Dockerfile.
+	// DockerArtifact *beta* describes an artifact built from a Dockerfile.
 	DockerArtifact *DockerArtifact `yaml:"docker,omitempty" yamltags:"oneOf=artifact"`
 
-	// BazelArtifact (beta) requires bazel CLI to be installed and the sources to
+	// BazelArtifact *beta* requires bazel CLI to be installed and the sources to
 	// contain [Bazel](https://bazel.build/) configuration files.
 	BazelArtifact *BazelArtifact `yaml:"bazel,omitempty" yamltags:"oneOf=artifact"`
 
-	// JibMavenArtifact (alpha) builds images using the
+	// JibMavenArtifact *alpha* builds images using the
 	// [Jib plugin for Maven](https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin).
 	JibMavenArtifact *JibMavenArtifact `yaml:"jibMaven,omitempty" yamltags:"oneOf=artifact"`
 
-	// JibGradleArtifact (alpha) builds images using the
+	// JibGradleArtifact *alpha* builds images using the
 	// [Jib plugin for Gradle](https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin).
 	JibGradleArtifact *JibGradleArtifact `yaml:"jibGradle,omitempty" yamltags:"oneOf=artifact"`
 }
 
-// DockerArtifact (beta) describes an artifact built from a Dockerfile,
+// DockerArtifact *beta* describes an artifact built from a Dockerfile,
 // usually using `docker build`.
 type DockerArtifact struct {
 	// DockerfilePath locates the Dockerfile relative to workspace.
@@ -554,7 +554,7 @@ type DockerArtifact struct {
 	CacheFrom []string `yaml:"cacheFrom,omitempty"`
 }
 
-// BazelArtifact (beta) describes an artifact built with [Bazel](https://bazel.build/).
+// BazelArtifact *beta* describes an artifact built with [Bazel](https://bazel.build/).
 type BazelArtifact struct {
 	// BuildTarget is the `bazel build` target to run.
 	// For example: `//:skaffold_example.tar`.
@@ -565,7 +565,7 @@ type BazelArtifact struct {
 	BuildArgs []string `yaml:"args,omitempty"`
 }
 
-// JibMavenArtifact (alpha) builds images using the
+// JibMavenArtifact *alpha* builds images using the
 // [Jib plugin for Maven](https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin).
 type JibMavenArtifact struct {
 	// Module selects which Maven module to build, for a multi module project.
@@ -579,7 +579,7 @@ type JibMavenArtifact struct {
 	Flags []string `yaml:"args,omitempty"`
 }
 
-// JibGradleArtifact (alpha) builds images using the
+// JibGradleArtifact *alpha* builds images using the
 // [Jib plugin for Gradle](https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin).
 type JibGradleArtifact struct {
 	// Project selects which Gradle project to build.

From 5daf0dc83ed5ef46f4e1096845073ed61dca9088 Mon Sep 17 00:00:00 2001
From: David Gageot <david@gageot.net>
Date: Fri, 1 Mar 2019 11:40:25 +0100
Subject: [PATCH 6/7] Remove EOL from html descriptions

Signed-off-by: David Gageot <david@gageot.net>
---
 docs/content/en/schemas/v1alpha1.json |  16 +-
 docs/content/en/schemas/v1alpha2.json |  44 +--
 docs/content/en/schemas/v1alpha3.json |  46 +--
 docs/content/en/schemas/v1alpha4.json |  60 ++--
 docs/content/en/schemas/v1alpha5.json |  62 ++--
 docs/content/en/schemas/v1beta1.json  |  62 ++--
 docs/content/en/schemas/v1beta2.json  |  62 ++--
 docs/content/en/schemas/v1beta3.json  |  64 ++---
 docs/content/en/schemas/v1beta4.json  |  66 ++---
 docs/content/en/schemas/v1beta5.json  | 368 ++++++++++++------------
 docs/content/en/schemas/v1beta6.json  | 388 +++++++++++++-------------
 hack/schemas/main.go                  |   2 +-
 12 files changed, 620 insertions(+), 620 deletions(-)

diff --git a/docs/content/en/schemas/v1alpha1.json b/docs/content/en/schemas/v1alpha1.json
index fa90d0a12e6..40b63289f49 100755
--- a/docs/content/en/schemas/v1alpha1.json
+++ b/docs/content/en/schemas/v1alpha1.json
@@ -34,7 +34,7 @@
       ],
       "additionalProperties": false,
       "description": "represents items that need should be built, along with the context in which they should be built.",
-      "x-intellij-html-description": "<p>represents items that need should be built, along with the context in which they should be built.</p>\n"
+      "x-intellij-html-description": "represents items that need should be built, along with the context in which they should be built."
     },
     "BuildConfig": {
       "anyOf": [
@@ -102,7 +102,7 @@
         }
       ],
       "description": "contains all the configuration for the build steps",
-      "x-intellij-html-description": "<p>contains all the configuration for the build steps</p>\n"
+      "x-intellij-html-description": "contains all the configuration for the build steps"
     },
     "BuildType": {
       "properties": {
@@ -119,7 +119,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.",
-      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the build step. Only one field should be populated.</p>\n"
+      "x-intellij-html-description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated."
     },
     "DeployConfig": {
       "anyOf": [
@@ -166,7 +166,7 @@
         }
       ],
       "description": "contains all the configuration needed by the deploy steps",
-      "x-intellij-html-description": "<p>contains all the configuration needed by the deploy steps</p>\n"
+      "x-intellij-html-description": "contains all the configuration needed by the deploy steps"
     },
     "DeployType": {
       "properties": {
@@ -183,7 +183,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.",
-      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.</p>\n"
+      "x-intellij-html-description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated."
     },
     "GoogleCloudBuild": {
       "properties": {
@@ -259,7 +259,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with `kubectl apply`",
-      "x-intellij-html-description": "<p>contains the configuration needed for deploying with <code>kubectl apply</code></p>\n"
+      "x-intellij-html-description": "contains the configuration needed for deploying with <code>kubectl apply</code>"
     },
     "LocalBuild": {
       "properties": {
@@ -272,7 +272,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository.",
-      "x-intellij-html-description": "<p>contains the fields needed to do a build on the local docker daemon and optionally push to a repository.</p>\n"
+      "x-intellij-html-description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository."
     },
     "Manifest": {
       "properties": {
@@ -320,7 +320,7 @@
       ],
       "additionalProperties": false,
       "description": "top level config object that is parsed from a skaffold.yaml",
-      "x-intellij-html-description": "<p>top level config object that is parsed from a skaffold.yaml</p>\n"
+      "x-intellij-html-description": "top level config object that is parsed from a skaffold.yaml"
     }
   }
 }
diff --git a/docs/content/en/schemas/v1alpha2.json b/docs/content/en/schemas/v1alpha2.json
index e6fe76e16dc..e007efdb335 100755
--- a/docs/content/en/schemas/v1alpha2.json
+++ b/docs/content/en/schemas/v1alpha2.json
@@ -64,7 +64,7 @@
         }
       ],
       "description": "represents items that need to be built, along with the context in which they should be built.",
-      "x-intellij-html-description": "<p>represents items that need to be built, along with the context in which they should be built.</p>\n"
+      "x-intellij-html-description": "represents items that need to be built, along with the context in which they should be built."
     },
     "ArtifactType": {
       "properties": {
@@ -180,7 +180,7 @@
         }
       ],
       "description": "contains all the configuration for the build steps",
-      "x-intellij-html-description": "<p>contains all the configuration for the build steps</p>\n"
+      "x-intellij-html-description": "contains all the configuration for the build steps"
     },
     "BuildType": {
       "properties": {
@@ -201,7 +201,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.",
-      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the build step. Only one field should be populated.</p>\n"
+      "x-intellij-html-description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated."
     },
     "DateTimeTagger": {
       "properties": {
@@ -218,7 +218,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the DateTime tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the DateTime tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the DateTime tagger."
     },
     "DeployConfig": {
       "anyOf": [
@@ -260,7 +260,7 @@
         }
       ],
       "description": "contains all the configuration needed by the deploy steps",
-      "x-intellij-html-description": "<p>contains all the configuration needed by the deploy steps</p>\n"
+      "x-intellij-html-description": "contains all the configuration needed by the deploy steps"
     },
     "DeployType": {
       "properties": {
@@ -281,7 +281,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.",
-      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.</p>\n"
+      "x-intellij-html-description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated."
     },
     "DockerArtifact": {
       "properties": {
@@ -325,11 +325,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the envTemplate tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the envTemplate tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the envTemplate tagger."
     },
     "GitTagger": {
       "description": "contains the configuration for the git tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the git tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the git tagger."
     },
     "GoogleCloudBuild": {
       "properties": {
@@ -358,11 +358,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a remote build on Google Cloud Build.",
-      "x-intellij-html-description": "<p>contains the fields needed to do a remote build on Google Cloud Build.</p>\n"
+      "x-intellij-html-description": "contains the fields needed to do a remote build on Google Cloud Build."
     },
     "HelmConventionConfig": {
       "description": "represents image config in the syntax of image.repository and image.tag",
-      "x-intellij-html-description": "<p>represents image config in the syntax of image.repository and image.tag</p>\n"
+      "x-intellij-html-description": "represents image config in the syntax of image.repository and image.tag"
     },
     "HelmDeploy": {
       "properties": {
@@ -378,7 +378,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with helm",
-      "x-intellij-html-description": "<p>contains the configuration needed for deploying with helm</p>\n"
+      "x-intellij-html-description": "contains the configuration needed for deploying with helm"
     },
     "HelmFQNConfig": {
       "properties": {
@@ -391,7 +391,7 @@
       ],
       "additionalProperties": false,
       "description": "represents image config to use the FullyQualifiedImageName as param to set",
-      "x-intellij-html-description": "<p>represents image config to use the FullyQualifiedImageName as param to set</p>\n"
+      "x-intellij-html-description": "represents image config to use the FullyQualifiedImageName as param to set"
     },
     "HelmImageConfig": {
       "properties": {
@@ -442,12 +442,12 @@
         "appVersion": {
           "type": "string",
           "description": "set the appVersion on the chart to this version",
-          "x-intellij-html-description": "<p>set the appVersion on the chart to this version</p>\n"
+          "x-intellij-html-description": "set the appVersion on the chart to this version"
         },
         "version": {
           "type": "string",
           "description": "sets the version on the chart to this semver version.",
-          "x-intellij-html-description": "<p>sets the version on the chart to this semver version.</p>\n"
+          "x-intellij-html-description": "sets the version on the chart to this semver version."
         }
       },
       "preferredOrder": [
@@ -456,7 +456,7 @@
       ],
       "additionalProperties": false,
       "description": "represents parameters for packaging helm chart.",
-      "x-intellij-html-description": "<p>represents parameters for packaging helm chart.</p>\n"
+      "x-intellij-html-description": "represents parameters for packaging helm chart."
     },
     "HelmRelease": {
       "properties": {
@@ -560,7 +560,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a on-cluster build using the kaniko image",
-      "x-intellij-html-description": "<p>contains the fields needed to do a on-cluster build using the kaniko image</p>\n"
+      "x-intellij-html-description": "contains the fields needed to do a on-cluster build using the kaniko image"
     },
     "KubectlDeploy": {
       "properties": {
@@ -589,7 +589,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with `kubectl apply`",
-      "x-intellij-html-description": "<p>contains the configuration needed for deploying with <code>kubectl apply</code></p>\n"
+      "x-intellij-html-description": "contains the configuration needed for deploying with <code>kubectl apply</code>"
     },
     "KubectlFlags": {
       "properties": {
@@ -622,7 +622,7 @@
       ],
       "additionalProperties": false,
       "description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).",
-      "x-intellij-html-description": "<p>describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).</p>\n"
+      "x-intellij-html-description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete)."
     },
     "KustomizeDeploy": {
       "properties": {
@@ -660,7 +660,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository.",
-      "x-intellij-html-description": "<p>contains the fields needed to do a build on the local docker daemon and optionally push to a repository.</p>\n"
+      "x-intellij-html-description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository."
     },
     "Profile": {
       "properties": {
@@ -681,11 +681,11 @@
       ],
       "additionalProperties": false,
       "description": "additional configuration that overrides default configuration when it is activated.",
-      "x-intellij-html-description": "<p>additional configuration that overrides default configuration when it is activated.</p>\n"
+      "x-intellij-html-description": "additional configuration that overrides default configuration when it is activated."
     },
     "ShaTagger": {
       "description": "contains the configuration for the SHA tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the SHA tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the SHA tagger."
     },
     "SkaffoldPipeline": {
       "properties": {
@@ -740,7 +740,7 @@
       ],
       "additionalProperties": false,
       "description": "contains all the configuration for the tagging step",
-      "x-intellij-html-description": "<p>contains all the configuration for the tagging step</p>\n"
+      "x-intellij-html-description": "contains all the configuration for the tagging step"
     }
   }
 }
diff --git a/docs/content/en/schemas/v1alpha3.json b/docs/content/en/schemas/v1alpha3.json
index 4cf6665d073..f2046b3ef2c 100755
--- a/docs/content/en/schemas/v1alpha3.json
+++ b/docs/content/en/schemas/v1alpha3.json
@@ -64,7 +64,7 @@
         }
       ],
       "description": "represents items that need to be built, along with the context in which they should be built.",
-      "x-intellij-html-description": "<p>represents items that need to be built, along with the context in which they should be built.</p>\n"
+      "x-intellij-html-description": "represents items that need to be built, along with the context in which they should be built."
     },
     "ArtifactType": {
       "properties": {
@@ -180,7 +180,7 @@
         }
       ],
       "description": "contains all the configuration for the build steps",
-      "x-intellij-html-description": "<p>contains all the configuration for the build steps</p>\n"
+      "x-intellij-html-description": "contains all the configuration for the build steps"
     },
     "BuildType": {
       "properties": {
@@ -201,7 +201,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.",
-      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the build step. Only one field should be populated.</p>\n"
+      "x-intellij-html-description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated."
     },
     "DateTimeTagger": {
       "properties": {
@@ -218,7 +218,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the DateTime tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the DateTime tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the DateTime tagger."
     },
     "DeployConfig": {
       "anyOf": [
@@ -260,7 +260,7 @@
         }
       ],
       "description": "contains all the configuration needed by the deploy steps",
-      "x-intellij-html-description": "<p>contains all the configuration needed by the deploy steps</p>\n"
+      "x-intellij-html-description": "contains all the configuration needed by the deploy steps"
     },
     "DeployType": {
       "properties": {
@@ -281,7 +281,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.",
-      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.</p>\n"
+      "x-intellij-html-description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated."
     },
     "DockerArtifact": {
       "properties": {
@@ -325,11 +325,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the envTemplate tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the envTemplate tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the envTemplate tagger."
     },
     "GitTagger": {
       "description": "contains the configuration for the git tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the git tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the git tagger."
     },
     "GoogleCloudBuild": {
       "properties": {
@@ -358,11 +358,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a remote build on Google Cloud Build.",
-      "x-intellij-html-description": "<p>contains the fields needed to do a remote build on Google Cloud Build.</p>\n"
+      "x-intellij-html-description": "contains the fields needed to do a remote build on Google Cloud Build."
     },
     "HelmConventionConfig": {
       "description": "represents image config in the syntax of image.repository and image.tag",
-      "x-intellij-html-description": "<p>represents image config in the syntax of image.repository and image.tag</p>\n"
+      "x-intellij-html-description": "represents image config in the syntax of image.repository and image.tag"
     },
     "HelmDeploy": {
       "properties": {
@@ -378,7 +378,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with helm",
-      "x-intellij-html-description": "<p>contains the configuration needed for deploying with helm</p>\n"
+      "x-intellij-html-description": "contains the configuration needed for deploying with helm"
     },
     "HelmFQNConfig": {
       "properties": {
@@ -391,7 +391,7 @@
       ],
       "additionalProperties": false,
       "description": "represents image config to use the FullyQualifiedImageName as param to set",
-      "x-intellij-html-description": "<p>represents image config to use the FullyQualifiedImageName as param to set</p>\n"
+      "x-intellij-html-description": "represents image config to use the FullyQualifiedImageName as param to set"
     },
     "HelmImageConfig": {
       "properties": {
@@ -442,12 +442,12 @@
         "appVersion": {
           "type": "string",
           "description": "set the appVersion on the chart to this version",
-          "x-intellij-html-description": "<p>set the appVersion on the chart to this version</p>\n"
+          "x-intellij-html-description": "set the appVersion on the chart to this version"
         },
         "version": {
           "type": "string",
           "description": "sets the version on the chart to this semver version.",
-          "x-intellij-html-description": "<p>sets the version on the chart to this semver version.</p>\n"
+          "x-intellij-html-description": "sets the version on the chart to this semver version."
         }
       },
       "preferredOrder": [
@@ -456,7 +456,7 @@
       ],
       "additionalProperties": false,
       "description": "represents parameters for packaging helm chart.",
-      "x-intellij-html-description": "<p>represents parameters for packaging helm chart.</p>\n"
+      "x-intellij-html-description": "represents parameters for packaging helm chart."
     },
     "HelmRelease": {
       "properties": {
@@ -564,7 +564,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a on-cluster build using the kaniko image",
-      "x-intellij-html-description": "<p>contains the fields needed to do a on-cluster build using the kaniko image</p>\n"
+      "x-intellij-html-description": "contains the fields needed to do a on-cluster build using the kaniko image"
     },
     "KanikoBuildContext": {
       "properties": {
@@ -577,7 +577,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the different fields available to specify a kaniko build context",
-      "x-intellij-html-description": "<p>contains the different fields available to specify a kaniko build context</p>\n"
+      "x-intellij-html-description": "contains the different fields available to specify a kaniko build context"
     },
     "KubectlDeploy": {
       "properties": {
@@ -606,7 +606,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with `kubectl apply`",
-      "x-intellij-html-description": "<p>contains the configuration needed for deploying with <code>kubectl apply</code></p>\n"
+      "x-intellij-html-description": "contains the configuration needed for deploying with <code>kubectl apply</code>"
     },
     "KubectlFlags": {
       "properties": {
@@ -639,7 +639,7 @@
       ],
       "additionalProperties": false,
       "description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).",
-      "x-intellij-html-description": "<p>describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).</p>\n"
+      "x-intellij-html-description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete)."
     },
     "KustomizeDeploy": {
       "properties": {
@@ -677,7 +677,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository.",
-      "x-intellij-html-description": "<p>contains the fields needed to do a build on the local docker daemon and optionally push to a repository.</p>\n"
+      "x-intellij-html-description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository."
     },
     "Profile": {
       "properties": {
@@ -698,11 +698,11 @@
       ],
       "additionalProperties": false,
       "description": "additional configuration that overrides default configuration when it is activated.",
-      "x-intellij-html-description": "<p>additional configuration that overrides default configuration when it is activated.</p>\n"
+      "x-intellij-html-description": "additional configuration that overrides default configuration when it is activated."
     },
     "ShaTagger": {
       "description": "contains the configuration for the SHA tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the SHA tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the SHA tagger."
     },
     "SkaffoldPipeline": {
       "properties": {
@@ -757,7 +757,7 @@
       ],
       "additionalProperties": false,
       "description": "contains all the configuration for the tagging step",
-      "x-intellij-html-description": "<p>contains all the configuration for the tagging step</p>\n"
+      "x-intellij-html-description": "contains all the configuration for the tagging step"
     }
   }
 }
diff --git a/docs/content/en/schemas/v1alpha4.json b/docs/content/en/schemas/v1alpha4.json
index a85d4dce504..a8576391e5c 100755
--- a/docs/content/en/schemas/v1alpha4.json
+++ b/docs/content/en/schemas/v1alpha4.json
@@ -142,7 +142,7 @@
         }
       ],
       "description": "represents items that need to be built, along with the context in which they should be built.",
-      "x-intellij-html-description": "<p>represents items that need to be built, along with the context in which they should be built.</p>\n"
+      "x-intellij-html-description": "represents items that need to be built, along with the context in which they should be built."
     },
     "ArtifactType": {
       "properties": {
@@ -178,7 +178,7 @@
       ],
       "additionalProperties": false,
       "description": "describes an artifact built with Bazel.",
-      "x-intellij-html-description": "<p>describes an artifact built with Bazel.</p>\n"
+      "x-intellij-html-description": "describes an artifact built with Bazel."
     },
     "BuildConfig": {
       "anyOf": [
@@ -268,7 +268,7 @@
         }
       ],
       "description": "contains all the configuration for the build steps",
-      "x-intellij-html-description": "<p>contains all the configuration for the build steps</p>\n"
+      "x-intellij-html-description": "contains all the configuration for the build steps"
     },
     "BuildType": {
       "properties": {
@@ -289,7 +289,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.",
-      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the build step. Only one field should be populated.</p>\n"
+      "x-intellij-html-description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated."
     },
     "DateTimeTagger": {
       "properties": {
@@ -306,7 +306,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the DateTime tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the DateTime tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the DateTime tagger."
     },
     "DeployConfig": {
       "anyOf": [
@@ -348,7 +348,7 @@
         }
       ],
       "description": "contains all the configuration needed by the deploy steps",
-      "x-intellij-html-description": "<p>contains all the configuration needed by the deploy steps</p>\n"
+      "x-intellij-html-description": "contains all the configuration needed by the deploy steps"
     },
     "DeployType": {
       "properties": {
@@ -369,7 +369,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.",
-      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.</p>\n"
+      "x-intellij-html-description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated."
     },
     "DockerArtifact": {
       "properties": {
@@ -402,7 +402,7 @@
       ],
       "additionalProperties": false,
       "description": "describes an artifact built from a Dockerfile, usually using `docker build`.",
-      "x-intellij-html-description": "<p>describes an artifact built from a Dockerfile, usually using <code>docker build</code>.</p>\n"
+      "x-intellij-html-description": "describes an artifact built from a Dockerfile, usually using <code>docker build</code>."
     },
     "EnvTemplateTagger": {
       "properties": {
@@ -415,11 +415,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the envTemplate tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the envTemplate tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the envTemplate tagger."
     },
     "GitTagger": {
       "description": "contains the configuration for the git tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the git tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the git tagger."
     },
     "GoogleCloudBuild": {
       "properties": {
@@ -448,11 +448,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a remote build on Google Cloud Build.",
-      "x-intellij-html-description": "<p>contains the fields needed to do a remote build on Google Cloud Build.</p>\n"
+      "x-intellij-html-description": "contains the fields needed to do a remote build on Google Cloud Build."
     },
     "HelmConventionConfig": {
       "description": "represents image config in the syntax of image.repository and image.tag",
-      "x-intellij-html-description": "<p>represents image config in the syntax of image.repository and image.tag</p>\n"
+      "x-intellij-html-description": "represents image config in the syntax of image.repository and image.tag"
     },
     "HelmDeploy": {
       "properties": {
@@ -468,7 +468,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with helm",
-      "x-intellij-html-description": "<p>contains the configuration needed for deploying with helm</p>\n"
+      "x-intellij-html-description": "contains the configuration needed for deploying with helm"
     },
     "HelmFQNConfig": {
       "properties": {
@@ -481,7 +481,7 @@
       ],
       "additionalProperties": false,
       "description": "represents image config to use the FullyQualifiedImageName as param to set",
-      "x-intellij-html-description": "<p>represents image config to use the FullyQualifiedImageName as param to set</p>\n"
+      "x-intellij-html-description": "represents image config to use the FullyQualifiedImageName as param to set"
     },
     "HelmImageConfig": {
       "properties": {
@@ -532,12 +532,12 @@
         "appVersion": {
           "type": "string",
           "description": "set the appVersion on the chart to this version",
-          "x-intellij-html-description": "<p>set the appVersion on the chart to this version</p>\n"
+          "x-intellij-html-description": "set the appVersion on the chart to this version"
         },
         "version": {
           "type": "string",
           "description": "sets the version on the chart to this semver version.",
-          "x-intellij-html-description": "<p>sets the version on the chart to this semver version.</p>\n"
+          "x-intellij-html-description": "sets the version on the chart to this semver version."
         }
       },
       "preferredOrder": [
@@ -546,7 +546,7 @@
       ],
       "additionalProperties": false,
       "description": "represents parameters for packaging helm chart.",
-      "x-intellij-html-description": "<p>represents parameters for packaging helm chart.</p>\n"
+      "x-intellij-html-description": "represents parameters for packaging helm chart."
     },
     "HelmRelease": {
       "properties": {
@@ -632,7 +632,7 @@
         "project": {
           "type": "string",
           "description": "Only multi-module",
-          "x-intellij-html-description": "<p>Only multi-module</p>\n"
+          "x-intellij-html-description": "Only multi-module"
         }
       },
       "preferredOrder": [
@@ -645,7 +645,7 @@
         "module": {
           "type": "string",
           "description": "Only multi-module",
-          "x-intellij-html-description": "<p>Only multi-module</p>\n"
+          "x-intellij-html-description": "Only multi-module"
         },
         "profile": {
           "type": "string"
@@ -688,7 +688,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a on-cluster build using the kaniko image",
-      "x-intellij-html-description": "<p>contains the fields needed to do a on-cluster build using the kaniko image</p>\n"
+      "x-intellij-html-description": "contains the fields needed to do a on-cluster build using the kaniko image"
     },
     "KanikoBuildContext": {
       "properties": {
@@ -705,7 +705,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the different fields available to specify a kaniko build context",
-      "x-intellij-html-description": "<p>contains the different fields available to specify a kaniko build context</p>\n"
+      "x-intellij-html-description": "contains the different fields available to specify a kaniko build context"
     },
     "KubectlDeploy": {
       "properties": {
@@ -734,7 +734,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with `kubectl apply`",
-      "x-intellij-html-description": "<p>contains the configuration needed for deploying with <code>kubectl apply</code></p>\n"
+      "x-intellij-html-description": "contains the configuration needed for deploying with <code>kubectl apply</code>"
     },
     "KubectlFlags": {
       "properties": {
@@ -767,7 +767,7 @@
       ],
       "additionalProperties": false,
       "description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).",
-      "x-intellij-html-description": "<p>describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).</p>\n"
+      "x-intellij-html-description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete)."
     },
     "KustomizeDeploy": {
       "properties": {
@@ -784,7 +784,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with kustomize.",
-      "x-intellij-html-description": "<p>contains the configuration needed for deploying with kustomize.</p>\n"
+      "x-intellij-html-description": "contains the configuration needed for deploying with kustomize."
     },
     "LocalBuild": {
       "properties": {
@@ -807,11 +807,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository.",
-      "x-intellij-html-description": "<p>contains the fields needed to do a build on the local docker daemon and optionally push to a repository.</p>\n"
+      "x-intellij-html-description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository."
     },
     "LocalDir": {
       "description": "represents the local directory kaniko build context",
-      "x-intellij-html-description": "<p>represents the local directory kaniko build context</p>\n"
+      "x-intellij-html-description": "represents the local directory kaniko build context"
     },
     "Profile": {
       "properties": {
@@ -839,11 +839,11 @@
       ],
       "additionalProperties": false,
       "description": "additional configuration that overrides default configuration when it is activated.",
-      "x-intellij-html-description": "<p>additional configuration that overrides default configuration when it is activated.</p>\n"
+      "x-intellij-html-description": "additional configuration that overrides default configuration when it is activated."
     },
     "ShaTagger": {
       "description": "contains the configuration for the SHA tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the SHA tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the SHA tagger."
     },
     "SkaffoldPipeline": {
       "properties": {
@@ -902,7 +902,7 @@
       ],
       "additionalProperties": false,
       "description": "contains all the configuration for the tagging step",
-      "x-intellij-html-description": "<p>contains all the configuration for the tagging step</p>\n"
+      "x-intellij-html-description": "contains all the configuration for the tagging step"
     },
     "TestCase": {
       "properties": {
@@ -923,7 +923,7 @@
       ],
       "additionalProperties": false,
       "description": "a struct containing all the specified test configuration for an image.",
-      "x-intellij-html-description": "<p>a struct containing all the specified test configuration for an image.</p>\n"
+      "x-intellij-html-description": "a struct containing all the specified test configuration for an image."
     },
     "TestConfig": {
       "items": {
diff --git a/docs/content/en/schemas/v1alpha5.json b/docs/content/en/schemas/v1alpha5.json
index fb548dbc3a5..3899dee36b4 100755
--- a/docs/content/en/schemas/v1alpha5.json
+++ b/docs/content/en/schemas/v1alpha5.json
@@ -142,7 +142,7 @@
         }
       ],
       "description": "represents items that need to be built, along with the context in which they should be built.",
-      "x-intellij-html-description": "<p>represents items that need to be built, along with the context in which they should be built.</p>\n"
+      "x-intellij-html-description": "represents items that need to be built, along with the context in which they should be built."
     },
     "ArtifactType": {
       "properties": {
@@ -190,7 +190,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a build on Azure Container Registry",
-      "x-intellij-html-description": "<p>contains the fields needed to do a build on Azure Container Registry</p>\n"
+      "x-intellij-html-description": "contains the fields needed to do a build on Azure Container Registry"
     },
     "BazelArtifact": {
       "properties": {
@@ -203,7 +203,7 @@
       ],
       "additionalProperties": false,
       "description": "describes an artifact built with Bazel.",
-      "x-intellij-html-description": "<p>describes an artifact built with Bazel.</p>\n"
+      "x-intellij-html-description": "describes an artifact built with Bazel."
     },
     "BuildConfig": {
       "anyOf": [
@@ -315,7 +315,7 @@
         }
       ],
       "description": "contains all the configuration for the build steps",
-      "x-intellij-html-description": "<p>contains all the configuration for the build steps</p>\n"
+      "x-intellij-html-description": "contains all the configuration for the build steps"
     },
     "BuildType": {
       "properties": {
@@ -340,7 +340,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.",
-      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the build step. Only one field should be populated.</p>\n"
+      "x-intellij-html-description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated."
     },
     "DateTimeTagger": {
       "properties": {
@@ -357,7 +357,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the DateTime tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the DateTime tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the DateTime tagger."
     },
     "DeployConfig": {
       "anyOf": [
@@ -399,7 +399,7 @@
         }
       ],
       "description": "contains all the configuration needed by the deploy steps",
-      "x-intellij-html-description": "<p>contains all the configuration needed by the deploy steps</p>\n"
+      "x-intellij-html-description": "contains all the configuration needed by the deploy steps"
     },
     "DeployType": {
       "properties": {
@@ -420,7 +420,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.",
-      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.</p>\n"
+      "x-intellij-html-description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated."
     },
     "DockerArtifact": {
       "properties": {
@@ -453,7 +453,7 @@
       ],
       "additionalProperties": false,
       "description": "describes an artifact built from a Dockerfile, usually using `docker build`.",
-      "x-intellij-html-description": "<p>describes an artifact built from a Dockerfile, usually using <code>docker build</code>.</p>\n"
+      "x-intellij-html-description": "describes an artifact built from a Dockerfile, usually using <code>docker build</code>."
     },
     "EnvTemplateTagger": {
       "properties": {
@@ -466,11 +466,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the envTemplate tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the envTemplate tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the envTemplate tagger."
     },
     "GitTagger": {
       "description": "contains the configuration for the git tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the git tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the git tagger."
     },
     "GoogleCloudBuild": {
       "properties": {
@@ -499,11 +499,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a remote build on Google Cloud Build.",
-      "x-intellij-html-description": "<p>contains the fields needed to do a remote build on Google Cloud Build.</p>\n"
+      "x-intellij-html-description": "contains the fields needed to do a remote build on Google Cloud Build."
     },
     "HelmConventionConfig": {
       "description": "represents image config in the syntax of image.repository and image.tag",
-      "x-intellij-html-description": "<p>represents image config in the syntax of image.repository and image.tag</p>\n"
+      "x-intellij-html-description": "represents image config in the syntax of image.repository and image.tag"
     },
     "HelmDeploy": {
       "properties": {
@@ -519,7 +519,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with helm",
-      "x-intellij-html-description": "<p>contains the configuration needed for deploying with helm</p>\n"
+      "x-intellij-html-description": "contains the configuration needed for deploying with helm"
     },
     "HelmFQNConfig": {
       "properties": {
@@ -532,7 +532,7 @@
       ],
       "additionalProperties": false,
       "description": "represents image config to use the FullyQualifiedImageName as param to set",
-      "x-intellij-html-description": "<p>represents image config to use the FullyQualifiedImageName as param to set</p>\n"
+      "x-intellij-html-description": "represents image config to use the FullyQualifiedImageName as param to set"
     },
     "HelmImageConfig": {
       "properties": {
@@ -583,12 +583,12 @@
         "appVersion": {
           "type": "string",
           "description": "set the appVersion on the chart to this version",
-          "x-intellij-html-description": "<p>set the appVersion on the chart to this version</p>\n"
+          "x-intellij-html-description": "set the appVersion on the chart to this version"
         },
         "version": {
           "type": "string",
           "description": "sets the version on the chart to this semver version.",
-          "x-intellij-html-description": "<p>sets the version on the chart to this semver version.</p>\n"
+          "x-intellij-html-description": "sets the version on the chart to this semver version."
         }
       },
       "preferredOrder": [
@@ -597,7 +597,7 @@
       ],
       "additionalProperties": false,
       "description": "represents parameters for packaging helm chart.",
-      "x-intellij-html-description": "<p>represents parameters for packaging helm chart.</p>\n"
+      "x-intellij-html-description": "represents parameters for packaging helm chart."
     },
     "HelmRelease": {
       "properties": {
@@ -683,7 +683,7 @@
         "project": {
           "type": "string",
           "description": "Only multi-module",
-          "x-intellij-html-description": "<p>Only multi-module</p>\n"
+          "x-intellij-html-description": "Only multi-module"
         }
       },
       "preferredOrder": [
@@ -696,7 +696,7 @@
         "module": {
           "type": "string",
           "description": "Only multi-module",
-          "x-intellij-html-description": "<p>Only multi-module</p>\n"
+          "x-intellij-html-description": "Only multi-module"
         },
         "profile": {
           "type": "string"
@@ -739,7 +739,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a on-cluster build using the kaniko image",
-      "x-intellij-html-description": "<p>contains the fields needed to do a on-cluster build using the kaniko image</p>\n"
+      "x-intellij-html-description": "contains the fields needed to do a on-cluster build using the kaniko image"
     },
     "KanikoBuildContext": {
       "properties": {
@@ -756,7 +756,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the different fields available to specify a kaniko build context",
-      "x-intellij-html-description": "<p>contains the different fields available to specify a kaniko build context</p>\n"
+      "x-intellij-html-description": "contains the different fields available to specify a kaniko build context"
     },
     "KubectlDeploy": {
       "properties": {
@@ -785,7 +785,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with `kubectl apply`",
-      "x-intellij-html-description": "<p>contains the configuration needed for deploying with <code>kubectl apply</code></p>\n"
+      "x-intellij-html-description": "contains the configuration needed for deploying with <code>kubectl apply</code>"
     },
     "KubectlFlags": {
       "properties": {
@@ -818,7 +818,7 @@
       ],
       "additionalProperties": false,
       "description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).",
-      "x-intellij-html-description": "<p>describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).</p>\n"
+      "x-intellij-html-description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete)."
     },
     "KustomizeDeploy": {
       "properties": {
@@ -835,7 +835,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with kustomize.",
-      "x-intellij-html-description": "<p>contains the configuration needed for deploying with kustomize.</p>\n"
+      "x-intellij-html-description": "contains the configuration needed for deploying with kustomize."
     },
     "LocalBuild": {
       "properties": {
@@ -858,11 +858,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository.",
-      "x-intellij-html-description": "<p>contains the fields needed to do a build on the local docker daemon and optionally push to a repository.</p>\n"
+      "x-intellij-html-description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository."
     },
     "LocalDir": {
       "description": "represents the local directory kaniko build context",
-      "x-intellij-html-description": "<p>represents the local directory kaniko build context</p>\n"
+      "x-intellij-html-description": "represents the local directory kaniko build context"
     },
     "Profile": {
       "properties": {
@@ -887,11 +887,11 @@
       ],
       "additionalProperties": false,
       "description": "additional configuration that overrides default configuration when it is activated.",
-      "x-intellij-html-description": "<p>additional configuration that overrides default configuration when it is activated.</p>\n"
+      "x-intellij-html-description": "additional configuration that overrides default configuration when it is activated."
     },
     "ShaTagger": {
       "description": "contains the configuration for the SHA tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the SHA tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the SHA tagger."
     },
     "SkaffoldPipeline": {
       "properties": {
@@ -950,7 +950,7 @@
       ],
       "additionalProperties": false,
       "description": "contains all the configuration for the tagging step",
-      "x-intellij-html-description": "<p>contains all the configuration for the tagging step</p>\n"
+      "x-intellij-html-description": "contains all the configuration for the tagging step"
     },
     "TestCase": {
       "properties": {
@@ -971,7 +971,7 @@
       ],
       "additionalProperties": false,
       "description": "a struct containing all the specified test configuration for an image.",
-      "x-intellij-html-description": "<p>a struct containing all the specified test configuration for an image.</p>\n"
+      "x-intellij-html-description": "a struct containing all the specified test configuration for an image."
     },
     "TestConfig": {
       "items": {
diff --git a/docs/content/en/schemas/v1beta1.json b/docs/content/en/schemas/v1beta1.json
index d2df595ee51..b1d93fb80b4 100755
--- a/docs/content/en/schemas/v1beta1.json
+++ b/docs/content/en/schemas/v1beta1.json
@@ -142,7 +142,7 @@
         }
       ],
       "description": "represents items that need to be built, along with the context in which they should be built.",
-      "x-intellij-html-description": "<p>represents items that need to be built, along with the context in which they should be built.</p>\n"
+      "x-intellij-html-description": "represents items that need to be built, along with the context in which they should be built."
     },
     "ArtifactType": {
       "properties": {
@@ -186,7 +186,7 @@
       ],
       "additionalProperties": false,
       "description": "describes an artifact built with Bazel.",
-      "x-intellij-html-description": "<p>describes an artifact built with Bazel.</p>\n"
+      "x-intellij-html-description": "describes an artifact built with Bazel."
     },
     "BuildConfig": {
       "anyOf": [
@@ -276,7 +276,7 @@
         }
       ],
       "description": "contains all the configuration for the build steps",
-      "x-intellij-html-description": "<p>contains all the configuration for the build steps</p>\n"
+      "x-intellij-html-description": "contains all the configuration for the build steps"
     },
     "BuildType": {
       "properties": {
@@ -297,7 +297,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.",
-      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the build step. Only one field should be populated.</p>\n"
+      "x-intellij-html-description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated."
     },
     "DateTimeTagger": {
       "properties": {
@@ -314,7 +314,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the DateTime tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the DateTime tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the DateTime tagger."
     },
     "DeployConfig": {
       "anyOf": [
@@ -356,7 +356,7 @@
         }
       ],
       "description": "contains all the configuration needed by the deploy steps",
-      "x-intellij-html-description": "<p>contains all the configuration needed by the deploy steps</p>\n"
+      "x-intellij-html-description": "contains all the configuration needed by the deploy steps"
     },
     "DeployType": {
       "properties": {
@@ -377,7 +377,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.",
-      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.</p>\n"
+      "x-intellij-html-description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated."
     },
     "DockerArtifact": {
       "properties": {
@@ -410,7 +410,7 @@
       ],
       "additionalProperties": false,
       "description": "describes an artifact built from a Dockerfile, usually using `docker build`.",
-      "x-intellij-html-description": "<p>describes an artifact built from a Dockerfile, usually using <code>docker build</code>.</p>\n"
+      "x-intellij-html-description": "describes an artifact built from a Dockerfile, usually using <code>docker build</code>."
     },
     "EnvTemplateTagger": {
       "properties": {
@@ -423,11 +423,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the envTemplate tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the envTemplate tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the envTemplate tagger."
     },
     "GitTagger": {
       "description": "contains the configuration for the git tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the git tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the git tagger."
     },
     "GoogleCloudBuild": {
       "properties": {
@@ -456,11 +456,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a remote build on Google Cloud Build.",
-      "x-intellij-html-description": "<p>contains the fields needed to do a remote build on Google Cloud Build.</p>\n"
+      "x-intellij-html-description": "contains the fields needed to do a remote build on Google Cloud Build."
     },
     "HelmConventionConfig": {
       "description": "represents image config in the syntax of image.repository and image.tag",
-      "x-intellij-html-description": "<p>represents image config in the syntax of image.repository and image.tag</p>\n"
+      "x-intellij-html-description": "represents image config in the syntax of image.repository and image.tag"
     },
     "HelmDeploy": {
       "properties": {
@@ -476,7 +476,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with helm",
-      "x-intellij-html-description": "<p>contains the configuration needed for deploying with helm</p>\n"
+      "x-intellij-html-description": "contains the configuration needed for deploying with helm"
     },
     "HelmFQNConfig": {
       "properties": {
@@ -489,7 +489,7 @@
       ],
       "additionalProperties": false,
       "description": "represents image config to use the FullyQualifiedImageName as param to set",
-      "x-intellij-html-description": "<p>represents image config to use the FullyQualifiedImageName as param to set</p>\n"
+      "x-intellij-html-description": "represents image config to use the FullyQualifiedImageName as param to set"
     },
     "HelmImageConfig": {
       "properties": {
@@ -540,12 +540,12 @@
         "appVersion": {
           "type": "string",
           "description": "set the appVersion on the chart to this version",
-          "x-intellij-html-description": "<p>set the appVersion on the chart to this version</p>\n"
+          "x-intellij-html-description": "set the appVersion on the chart to this version"
         },
         "version": {
           "type": "string",
           "description": "sets the version on the chart to this semver version.",
-          "x-intellij-html-description": "<p>sets the version on the chart to this semver version.</p>\n"
+          "x-intellij-html-description": "sets the version on the chart to this semver version."
         }
       },
       "preferredOrder": [
@@ -554,7 +554,7 @@
       ],
       "additionalProperties": false,
       "description": "represents parameters for packaging helm chart.",
-      "x-intellij-html-description": "<p>represents parameters for packaging helm chart.</p>\n"
+      "x-intellij-html-description": "represents parameters for packaging helm chart."
     },
     "HelmRelease": {
       "properties": {
@@ -640,7 +640,7 @@
         "project": {
           "type": "string",
           "description": "Only multi-module",
-          "x-intellij-html-description": "<p>Only multi-module</p>\n"
+          "x-intellij-html-description": "Only multi-module"
         }
       },
       "preferredOrder": [
@@ -653,7 +653,7 @@
         "module": {
           "type": "string",
           "description": "Only multi-module",
-          "x-intellij-html-description": "<p>Only multi-module</p>\n"
+          "x-intellij-html-description": "Only multi-module"
         },
         "profile": {
           "type": "string"
@@ -700,7 +700,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a on-cluster build using the kaniko image",
-      "x-intellij-html-description": "<p>contains the fields needed to do a on-cluster build using the kaniko image</p>\n"
+      "x-intellij-html-description": "contains the fields needed to do a on-cluster build using the kaniko image"
     },
     "KanikoBuildContext": {
       "properties": {
@@ -717,7 +717,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the different fields available to specify a kaniko build context",
-      "x-intellij-html-description": "<p>contains the different fields available to specify a kaniko build context</p>\n"
+      "x-intellij-html-description": "contains the different fields available to specify a kaniko build context"
     },
     "KanikoCache": {
       "properties": {
@@ -730,7 +730,7 @@
       ],
       "additionalProperties": false,
       "description": "contains fields related to kaniko caching",
-      "x-intellij-html-description": "<p>contains fields related to kaniko caching</p>\n"
+      "x-intellij-html-description": "contains fields related to kaniko caching"
     },
     "KubectlDeploy": {
       "properties": {
@@ -759,7 +759,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with `kubectl apply`",
-      "x-intellij-html-description": "<p>contains the configuration needed for deploying with <code>kubectl apply</code></p>\n"
+      "x-intellij-html-description": "contains the configuration needed for deploying with <code>kubectl apply</code>"
     },
     "KubectlFlags": {
       "properties": {
@@ -792,7 +792,7 @@
       ],
       "additionalProperties": false,
       "description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).",
-      "x-intellij-html-description": "<p>describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).</p>\n"
+      "x-intellij-html-description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete)."
     },
     "KustomizeDeploy": {
       "properties": {
@@ -809,7 +809,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with kustomize.",
-      "x-intellij-html-description": "<p>contains the configuration needed for deploying with kustomize.</p>\n"
+      "x-intellij-html-description": "contains the configuration needed for deploying with kustomize."
     },
     "LocalBuild": {
       "properties": {
@@ -832,11 +832,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository.",
-      "x-intellij-html-description": "<p>contains the fields needed to do a build on the local docker daemon and optionally push to a repository.</p>\n"
+      "x-intellij-html-description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository."
     },
     "LocalDir": {
       "description": "represents the local directory kaniko build context",
-      "x-intellij-html-description": "<p>represents the local directory kaniko build context</p>\n"
+      "x-intellij-html-description": "represents the local directory kaniko build context"
     },
     "Profile": {
       "properties": {
@@ -861,11 +861,11 @@
       ],
       "additionalProperties": false,
       "description": "additional configuration that overrides default configuration when it is activated.",
-      "x-intellij-html-description": "<p>additional configuration that overrides default configuration when it is activated.</p>\n"
+      "x-intellij-html-description": "additional configuration that overrides default configuration when it is activated."
     },
     "ShaTagger": {
       "description": "contains the configuration for the SHA tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the SHA tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the SHA tagger."
     },
     "SkaffoldPipeline": {
       "properties": {
@@ -924,7 +924,7 @@
       ],
       "additionalProperties": false,
       "description": "contains all the configuration for the tagging step",
-      "x-intellij-html-description": "<p>contains all the configuration for the tagging step</p>\n"
+      "x-intellij-html-description": "contains all the configuration for the tagging step"
     },
     "TestCase": {
       "properties": {
@@ -945,7 +945,7 @@
       ],
       "additionalProperties": false,
       "description": "a struct containing all the specified test configuration for an image.",
-      "x-intellij-html-description": "<p>a struct containing all the specified test configuration for an image.</p>\n"
+      "x-intellij-html-description": "a struct containing all the specified test configuration for an image."
     },
     "TestConfig": {
       "items": {
diff --git a/docs/content/en/schemas/v1beta2.json b/docs/content/en/schemas/v1beta2.json
index 1ed125ae090..16e92fd5c2a 100755
--- a/docs/content/en/schemas/v1beta2.json
+++ b/docs/content/en/schemas/v1beta2.json
@@ -142,7 +142,7 @@
         }
       ],
       "description": "represents items that need to be built, along with the context in which they should be built.",
-      "x-intellij-html-description": "<p>represents items that need to be built, along with the context in which they should be built.</p>\n"
+      "x-intellij-html-description": "represents items that need to be built, along with the context in which they should be built."
     },
     "ArtifactType": {
       "properties": {
@@ -186,7 +186,7 @@
       ],
       "additionalProperties": false,
       "description": "describes an artifact built with Bazel.",
-      "x-intellij-html-description": "<p>describes an artifact built with Bazel.</p>\n"
+      "x-intellij-html-description": "describes an artifact built with Bazel."
     },
     "BuildConfig": {
       "anyOf": [
@@ -276,7 +276,7 @@
         }
       ],
       "description": "contains all the configuration for the build steps",
-      "x-intellij-html-description": "<p>contains all the configuration for the build steps</p>\n"
+      "x-intellij-html-description": "contains all the configuration for the build steps"
     },
     "BuildType": {
       "properties": {
@@ -297,7 +297,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.",
-      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the build step. Only one field should be populated.</p>\n"
+      "x-intellij-html-description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated."
     },
     "DateTimeTagger": {
       "properties": {
@@ -314,7 +314,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the DateTime tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the DateTime tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the DateTime tagger."
     },
     "DeployConfig": {
       "anyOf": [
@@ -356,7 +356,7 @@
         }
       ],
       "description": "contains all the configuration needed by the deploy steps",
-      "x-intellij-html-description": "<p>contains all the configuration needed by the deploy steps</p>\n"
+      "x-intellij-html-description": "contains all the configuration needed by the deploy steps"
     },
     "DeployType": {
       "properties": {
@@ -377,7 +377,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.",
-      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.</p>\n"
+      "x-intellij-html-description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated."
     },
     "DockerArtifact": {
       "properties": {
@@ -410,7 +410,7 @@
       ],
       "additionalProperties": false,
       "description": "describes an artifact built from a Dockerfile, usually using `docker build`.",
-      "x-intellij-html-description": "<p>describes an artifact built from a Dockerfile, usually using <code>docker build</code>.</p>\n"
+      "x-intellij-html-description": "describes an artifact built from a Dockerfile, usually using <code>docker build</code>."
     },
     "EnvTemplateTagger": {
       "properties": {
@@ -423,11 +423,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the envTemplate tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the envTemplate tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the envTemplate tagger."
     },
     "GitTagger": {
       "description": "contains the configuration for the git tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the git tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the git tagger."
     },
     "GoogleCloudBuild": {
       "properties": {
@@ -456,11 +456,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a remote build on Google Cloud Build.",
-      "x-intellij-html-description": "<p>contains the fields needed to do a remote build on Google Cloud Build.</p>\n"
+      "x-intellij-html-description": "contains the fields needed to do a remote build on Google Cloud Build."
     },
     "HelmConventionConfig": {
       "description": "represents image config in the syntax of image.repository and image.tag",
-      "x-intellij-html-description": "<p>represents image config in the syntax of image.repository and image.tag</p>\n"
+      "x-intellij-html-description": "represents image config in the syntax of image.repository and image.tag"
     },
     "HelmDeploy": {
       "properties": {
@@ -476,7 +476,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with helm",
-      "x-intellij-html-description": "<p>contains the configuration needed for deploying with helm</p>\n"
+      "x-intellij-html-description": "contains the configuration needed for deploying with helm"
     },
     "HelmFQNConfig": {
       "properties": {
@@ -489,7 +489,7 @@
       ],
       "additionalProperties": false,
       "description": "represents image config to use the FullyQualifiedImageName as param to set",
-      "x-intellij-html-description": "<p>represents image config to use the FullyQualifiedImageName as param to set</p>\n"
+      "x-intellij-html-description": "represents image config to use the FullyQualifiedImageName as param to set"
     },
     "HelmImageConfig": {
       "properties": {
@@ -540,12 +540,12 @@
         "appVersion": {
           "type": "string",
           "description": "set the appVersion on the chart to this version",
-          "x-intellij-html-description": "<p>set the appVersion on the chart to this version</p>\n"
+          "x-intellij-html-description": "set the appVersion on the chart to this version"
         },
         "version": {
           "type": "string",
           "description": "sets the version on the chart to this semver version.",
-          "x-intellij-html-description": "<p>sets the version on the chart to this semver version.</p>\n"
+          "x-intellij-html-description": "sets the version on the chart to this semver version."
         }
       },
       "preferredOrder": [
@@ -554,7 +554,7 @@
       ],
       "additionalProperties": false,
       "description": "represents parameters for packaging helm chart.",
-      "x-intellij-html-description": "<p>represents parameters for packaging helm chart.</p>\n"
+      "x-intellij-html-description": "represents parameters for packaging helm chart."
     },
     "HelmRelease": {
       "properties": {
@@ -640,7 +640,7 @@
         "project": {
           "type": "string",
           "description": "Only multi-module",
-          "x-intellij-html-description": "<p>Only multi-module</p>\n"
+          "x-intellij-html-description": "Only multi-module"
         }
       },
       "preferredOrder": [
@@ -653,7 +653,7 @@
         "module": {
           "type": "string",
           "description": "Only multi-module",
-          "x-intellij-html-description": "<p>Only multi-module</p>\n"
+          "x-intellij-html-description": "Only multi-module"
         },
         "profile": {
           "type": "string"
@@ -708,7 +708,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a on-cluster build using the kaniko image",
-      "x-intellij-html-description": "<p>contains the fields needed to do a on-cluster build using the kaniko image</p>\n"
+      "x-intellij-html-description": "contains the fields needed to do a on-cluster build using the kaniko image"
     },
     "KanikoBuildContext": {
       "properties": {
@@ -725,7 +725,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the different fields available to specify a kaniko build context",
-      "x-intellij-html-description": "<p>contains the different fields available to specify a kaniko build context</p>\n"
+      "x-intellij-html-description": "contains the different fields available to specify a kaniko build context"
     },
     "KanikoCache": {
       "properties": {
@@ -738,7 +738,7 @@
       ],
       "additionalProperties": false,
       "description": "contains fields related to kaniko caching",
-      "x-intellij-html-description": "<p>contains fields related to kaniko caching</p>\n"
+      "x-intellij-html-description": "contains fields related to kaniko caching"
     },
     "KubectlDeploy": {
       "properties": {
@@ -767,7 +767,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with `kubectl apply`",
-      "x-intellij-html-description": "<p>contains the configuration needed for deploying with <code>kubectl apply</code></p>\n"
+      "x-intellij-html-description": "contains the configuration needed for deploying with <code>kubectl apply</code>"
     },
     "KubectlFlags": {
       "properties": {
@@ -800,7 +800,7 @@
       ],
       "additionalProperties": false,
       "description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).",
-      "x-intellij-html-description": "<p>describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).</p>\n"
+      "x-intellij-html-description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete)."
     },
     "KustomizeDeploy": {
       "properties": {
@@ -817,7 +817,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with kustomize.",
-      "x-intellij-html-description": "<p>contains the configuration needed for deploying with kustomize.</p>\n"
+      "x-intellij-html-description": "contains the configuration needed for deploying with kustomize."
     },
     "LocalBuild": {
       "properties": {
@@ -840,11 +840,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository.",
-      "x-intellij-html-description": "<p>contains the fields needed to do a build on the local docker daemon and optionally push to a repository.</p>\n"
+      "x-intellij-html-description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository."
     },
     "LocalDir": {
       "description": "represents the local directory kaniko build context",
-      "x-intellij-html-description": "<p>represents the local directory kaniko build context</p>\n"
+      "x-intellij-html-description": "represents the local directory kaniko build context"
     },
     "Profile": {
       "properties": {
@@ -869,11 +869,11 @@
       ],
       "additionalProperties": false,
       "description": "additional configuration that overrides default configuration when it is activated.",
-      "x-intellij-html-description": "<p>additional configuration that overrides default configuration when it is activated.</p>\n"
+      "x-intellij-html-description": "additional configuration that overrides default configuration when it is activated."
     },
     "ShaTagger": {
       "description": "contains the configuration for the SHA tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the SHA tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the SHA tagger."
     },
     "SkaffoldPipeline": {
       "properties": {
@@ -932,7 +932,7 @@
       ],
       "additionalProperties": false,
       "description": "contains all the configuration for the tagging step",
-      "x-intellij-html-description": "<p>contains all the configuration for the tagging step</p>\n"
+      "x-intellij-html-description": "contains all the configuration for the tagging step"
     },
     "TestCase": {
       "properties": {
@@ -953,7 +953,7 @@
       ],
       "additionalProperties": false,
       "description": "a struct containing all the specified test configuration for an image.",
-      "x-intellij-html-description": "<p>a struct containing all the specified test configuration for an image.</p>\n"
+      "x-intellij-html-description": "a struct containing all the specified test configuration for an image."
     },
     "TestConfig": {
       "items": {
diff --git a/docs/content/en/schemas/v1beta3.json b/docs/content/en/schemas/v1beta3.json
index 57adfabf3ab..2636de02b5e 100755
--- a/docs/content/en/schemas/v1beta3.json
+++ b/docs/content/en/schemas/v1beta3.json
@@ -142,7 +142,7 @@
         }
       ],
       "description": "represents items that need to be built, along with the context in which they should be built.",
-      "x-intellij-html-description": "<p>represents items that need to be built, along with the context in which they should be built.</p>\n"
+      "x-intellij-html-description": "represents items that need to be built, along with the context in which they should be built."
     },
     "ArtifactType": {
       "properties": {
@@ -186,7 +186,7 @@
       ],
       "additionalProperties": false,
       "description": "describes an artifact built with Bazel.",
-      "x-intellij-html-description": "<p>describes an artifact built with Bazel.</p>\n"
+      "x-intellij-html-description": "describes an artifact built with Bazel."
     },
     "BuildConfig": {
       "anyOf": [
@@ -276,7 +276,7 @@
         }
       ],
       "description": "contains all the configuration for the build steps",
-      "x-intellij-html-description": "<p>contains all the configuration for the build steps</p>\n"
+      "x-intellij-html-description": "contains all the configuration for the build steps"
     },
     "BuildType": {
       "properties": {
@@ -297,7 +297,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.",
-      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the build step. Only one field should be populated.</p>\n"
+      "x-intellij-html-description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated."
     },
     "DateTimeTagger": {
       "properties": {
@@ -314,7 +314,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the DateTime tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the DateTime tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the DateTime tagger."
     },
     "DeployConfig": {
       "anyOf": [
@@ -356,7 +356,7 @@
         }
       ],
       "description": "contains all the configuration needed by the deploy steps",
-      "x-intellij-html-description": "<p>contains all the configuration needed by the deploy steps</p>\n"
+      "x-intellij-html-description": "contains all the configuration needed by the deploy steps"
     },
     "DeployType": {
       "properties": {
@@ -377,7 +377,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.",
-      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.</p>\n"
+      "x-intellij-html-description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated."
     },
     "DockerArtifact": {
       "properties": {
@@ -410,7 +410,7 @@
       ],
       "additionalProperties": false,
       "description": "describes an artifact built from a Dockerfile, usually using `docker build`.",
-      "x-intellij-html-description": "<p>describes an artifact built from a Dockerfile, usually using <code>docker build</code>.</p>\n"
+      "x-intellij-html-description": "describes an artifact built from a Dockerfile, usually using <code>docker build</code>."
     },
     "DockerConfig": {
       "properties": {
@@ -427,7 +427,7 @@
       ],
       "additionalProperties": false,
       "description": "contains information about the docker config.json to mount",
-      "x-intellij-html-description": "<p>contains information about the docker config.json to mount</p>\n"
+      "x-intellij-html-description": "contains information about the docker config.json to mount"
     },
     "EnvTemplateTagger": {
       "properties": {
@@ -440,11 +440,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the envTemplate tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the envTemplate tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the envTemplate tagger."
     },
     "GitTagger": {
       "description": "contains the configuration for the git tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the git tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the git tagger."
     },
     "GoogleCloudBuild": {
       "properties": {
@@ -481,11 +481,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a remote build on Google Cloud Build.",
-      "x-intellij-html-description": "<p>contains the fields needed to do a remote build on Google Cloud Build.</p>\n"
+      "x-intellij-html-description": "contains the fields needed to do a remote build on Google Cloud Build."
     },
     "HelmConventionConfig": {
       "description": "represents image config in the syntax of image.repository and image.tag",
-      "x-intellij-html-description": "<p>represents image config in the syntax of image.repository and image.tag</p>\n"
+      "x-intellij-html-description": "represents image config in the syntax of image.repository and image.tag"
     },
     "HelmDeploy": {
       "properties": {
@@ -501,7 +501,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with helm",
-      "x-intellij-html-description": "<p>contains the configuration needed for deploying with helm</p>\n"
+      "x-intellij-html-description": "contains the configuration needed for deploying with helm"
     },
     "HelmFQNConfig": {
       "properties": {
@@ -514,7 +514,7 @@
       ],
       "additionalProperties": false,
       "description": "represents image config to use the FullyQualifiedImageName as param to set",
-      "x-intellij-html-description": "<p>represents image config to use the FullyQualifiedImageName as param to set</p>\n"
+      "x-intellij-html-description": "represents image config to use the FullyQualifiedImageName as param to set"
     },
     "HelmImageConfig": {
       "properties": {
@@ -565,12 +565,12 @@
         "appVersion": {
           "type": "string",
           "description": "set the appVersion on the chart to this version",
-          "x-intellij-html-description": "<p>set the appVersion on the chart to this version</p>\n"
+          "x-intellij-html-description": "set the appVersion on the chart to this version"
         },
         "version": {
           "type": "string",
           "description": "sets the version on the chart to this semver version.",
-          "x-intellij-html-description": "<p>sets the version on the chart to this semver version.</p>\n"
+          "x-intellij-html-description": "sets the version on the chart to this semver version."
         }
       },
       "preferredOrder": [
@@ -579,7 +579,7 @@
       ],
       "additionalProperties": false,
       "description": "represents parameters for packaging helm chart.",
-      "x-intellij-html-description": "<p>represents parameters for packaging helm chart.</p>\n"
+      "x-intellij-html-description": "represents parameters for packaging helm chart."
     },
     "HelmRelease": {
       "properties": {
@@ -665,7 +665,7 @@
         "project": {
           "type": "string",
           "description": "Only multi-module",
-          "x-intellij-html-description": "<p>Only multi-module</p>\n"
+          "x-intellij-html-description": "Only multi-module"
         }
       },
       "preferredOrder": [
@@ -678,7 +678,7 @@
         "module": {
           "type": "string",
           "description": "Only multi-module",
-          "x-intellij-html-description": "<p>Only multi-module</p>\n"
+          "x-intellij-html-description": "Only multi-module"
         },
         "profile": {
           "type": "string"
@@ -737,7 +737,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a on-cluster build using the kaniko image",
-      "x-intellij-html-description": "<p>contains the fields needed to do a on-cluster build using the kaniko image</p>\n"
+      "x-intellij-html-description": "contains the fields needed to do a on-cluster build using the kaniko image"
     },
     "KanikoBuildContext": {
       "properties": {
@@ -754,7 +754,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the different fields available to specify a kaniko build context",
-      "x-intellij-html-description": "<p>contains the different fields available to specify a kaniko build context</p>\n"
+      "x-intellij-html-description": "contains the different fields available to specify a kaniko build context"
     },
     "KanikoCache": {
       "properties": {
@@ -767,7 +767,7 @@
       ],
       "additionalProperties": false,
       "description": "contains fields related to kaniko caching",
-      "x-intellij-html-description": "<p>contains fields related to kaniko caching</p>\n"
+      "x-intellij-html-description": "contains fields related to kaniko caching"
     },
     "KubectlDeploy": {
       "properties": {
@@ -796,7 +796,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with `kubectl apply`",
-      "x-intellij-html-description": "<p>contains the configuration needed for deploying with <code>kubectl apply</code></p>\n"
+      "x-intellij-html-description": "contains the configuration needed for deploying with <code>kubectl apply</code>"
     },
     "KubectlFlags": {
       "properties": {
@@ -829,7 +829,7 @@
       ],
       "additionalProperties": false,
       "description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).",
-      "x-intellij-html-description": "<p>describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).</p>\n"
+      "x-intellij-html-description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete)."
     },
     "KustomizeDeploy": {
       "properties": {
@@ -846,7 +846,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with kustomize.",
-      "x-intellij-html-description": "<p>contains the configuration needed for deploying with kustomize.</p>\n"
+      "x-intellij-html-description": "contains the configuration needed for deploying with kustomize."
     },
     "LocalBuild": {
       "properties": {
@@ -869,11 +869,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository.",
-      "x-intellij-html-description": "<p>contains the fields needed to do a build on the local docker daemon and optionally push to a repository.</p>\n"
+      "x-intellij-html-description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository."
     },
     "LocalDir": {
       "description": "represents the local directory kaniko build context",
-      "x-intellij-html-description": "<p>represents the local directory kaniko build context</p>\n"
+      "x-intellij-html-description": "represents the local directory kaniko build context"
     },
     "Profile": {
       "properties": {
@@ -898,11 +898,11 @@
       ],
       "additionalProperties": false,
       "description": "additional configuration that overrides default configuration when it is activated.",
-      "x-intellij-html-description": "<p>additional configuration that overrides default configuration when it is activated.</p>\n"
+      "x-intellij-html-description": "additional configuration that overrides default configuration when it is activated."
     },
     "ShaTagger": {
       "description": "contains the configuration for the SHA tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the SHA tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the SHA tagger."
     },
     "SkaffoldPipeline": {
       "properties": {
@@ -961,7 +961,7 @@
       ],
       "additionalProperties": false,
       "description": "contains all the configuration for the tagging step",
-      "x-intellij-html-description": "<p>contains all the configuration for the tagging step</p>\n"
+      "x-intellij-html-description": "contains all the configuration for the tagging step"
     },
     "TestCase": {
       "properties": {
@@ -982,7 +982,7 @@
       ],
       "additionalProperties": false,
       "description": "a struct containing all the specified test configuration for an image.",
-      "x-intellij-html-description": "<p>a struct containing all the specified test configuration for an image.</p>\n"
+      "x-intellij-html-description": "a struct containing all the specified test configuration for an image."
     },
     "TestConfig": {
       "items": {
diff --git a/docs/content/en/schemas/v1beta4.json b/docs/content/en/schemas/v1beta4.json
index 0ff16962b35..1c1171a9e30 100755
--- a/docs/content/en/schemas/v1beta4.json
+++ b/docs/content/en/schemas/v1beta4.json
@@ -26,7 +26,7 @@
       ],
       "additionalProperties": false,
       "description": "defines criteria to auto-activate a profile.",
-      "x-intellij-html-description": "<p>defines criteria to auto-activate a profile.</p>\n"
+      "x-intellij-html-description": "defines criteria to auto-activate a profile."
     },
     "Artifact": {
       "anyOf": [
@@ -163,7 +163,7 @@
         }
       ],
       "description": "represents items that need to be built, along with the context in which they should be built.",
-      "x-intellij-html-description": "<p>represents items that need to be built, along with the context in which they should be built.</p>\n"
+      "x-intellij-html-description": "represents items that need to be built, along with the context in which they should be built."
     },
     "ArtifactType": {
       "properties": {
@@ -207,7 +207,7 @@
       ],
       "additionalProperties": false,
       "description": "describes an artifact built with Bazel.",
-      "x-intellij-html-description": "<p>describes an artifact built with Bazel.</p>\n"
+      "x-intellij-html-description": "describes an artifact built with Bazel."
     },
     "BuildConfig": {
       "anyOf": [
@@ -297,7 +297,7 @@
         }
       ],
       "description": "contains all the configuration for the build steps",
-      "x-intellij-html-description": "<p>contains all the configuration for the build steps</p>\n"
+      "x-intellij-html-description": "contains all the configuration for the build steps"
     },
     "BuildType": {
       "properties": {
@@ -318,7 +318,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.",
-      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the build step. Only one field should be populated.</p>\n"
+      "x-intellij-html-description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated."
     },
     "DateTimeTagger": {
       "properties": {
@@ -335,7 +335,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the DateTime tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the DateTime tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the DateTime tagger."
     },
     "DeployConfig": {
       "anyOf": [
@@ -377,7 +377,7 @@
         }
       ],
       "description": "contains all the configuration needed by the deploy steps",
-      "x-intellij-html-description": "<p>contains all the configuration needed by the deploy steps</p>\n"
+      "x-intellij-html-description": "contains all the configuration needed by the deploy steps"
     },
     "DeployType": {
       "properties": {
@@ -398,7 +398,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.",
-      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.</p>\n"
+      "x-intellij-html-description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated."
     },
     "DockerArtifact": {
       "properties": {
@@ -431,7 +431,7 @@
       ],
       "additionalProperties": false,
       "description": "describes an artifact built from a Dockerfile, usually using `docker build`.",
-      "x-intellij-html-description": "<p>describes an artifact built from a Dockerfile, usually using <code>docker build</code>.</p>\n"
+      "x-intellij-html-description": "describes an artifact built from a Dockerfile, usually using <code>docker build</code>."
     },
     "DockerConfig": {
       "properties": {
@@ -448,7 +448,7 @@
       ],
       "additionalProperties": false,
       "description": "contains information about the docker config.json to mount",
-      "x-intellij-html-description": "<p>contains information about the docker config.json to mount</p>\n"
+      "x-intellij-html-description": "contains information about the docker config.json to mount"
     },
     "EnvTemplateTagger": {
       "properties": {
@@ -461,11 +461,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration for the envTemplate tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the envTemplate tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the envTemplate tagger."
     },
     "GitTagger": {
       "description": "contains the configuration for the git tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the git tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the git tagger."
     },
     "GoogleCloudBuild": {
       "properties": {
@@ -502,11 +502,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a remote build on Google Cloud Build.",
-      "x-intellij-html-description": "<p>contains the fields needed to do a remote build on Google Cloud Build.</p>\n"
+      "x-intellij-html-description": "contains the fields needed to do a remote build on Google Cloud Build."
     },
     "HelmConventionConfig": {
       "description": "represents image config in the syntax of image.repository and image.tag",
-      "x-intellij-html-description": "<p>represents image config in the syntax of image.repository and image.tag</p>\n"
+      "x-intellij-html-description": "represents image config in the syntax of image.repository and image.tag"
     },
     "HelmDeploy": {
       "properties": {
@@ -522,7 +522,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with helm",
-      "x-intellij-html-description": "<p>contains the configuration needed for deploying with helm</p>\n"
+      "x-intellij-html-description": "contains the configuration needed for deploying with helm"
     },
     "HelmFQNConfig": {
       "properties": {
@@ -535,7 +535,7 @@
       ],
       "additionalProperties": false,
       "description": "represents image config to use the FullyQualifiedImageName as param to set",
-      "x-intellij-html-description": "<p>represents image config to use the FullyQualifiedImageName as param to set</p>\n"
+      "x-intellij-html-description": "represents image config to use the FullyQualifiedImageName as param to set"
     },
     "HelmImageConfig": {
       "properties": {
@@ -586,12 +586,12 @@
         "appVersion": {
           "type": "string",
           "description": "set the appVersion on the chart to this version",
-          "x-intellij-html-description": "<p>set the appVersion on the chart to this version</p>\n"
+          "x-intellij-html-description": "set the appVersion on the chart to this version"
         },
         "version": {
           "type": "string",
           "description": "sets the version on the chart to this semver version.",
-          "x-intellij-html-description": "<p>sets the version on the chart to this semver version.</p>\n"
+          "x-intellij-html-description": "sets the version on the chart to this semver version."
         }
       },
       "preferredOrder": [
@@ -600,7 +600,7 @@
       ],
       "additionalProperties": false,
       "description": "represents parameters for packaging helm chart.",
-      "x-intellij-html-description": "<p>represents parameters for packaging helm chart.</p>\n"
+      "x-intellij-html-description": "represents parameters for packaging helm chart."
     },
     "HelmRelease": {
       "properties": {
@@ -691,7 +691,7 @@
         "project": {
           "type": "string",
           "description": "Only multi-module",
-          "x-intellij-html-description": "<p>Only multi-module</p>\n"
+          "x-intellij-html-description": "Only multi-module"
         }
       },
       "preferredOrder": [
@@ -704,7 +704,7 @@
         "module": {
           "type": "string",
           "description": "Only multi-module",
-          "x-intellij-html-description": "<p>Only multi-module</p>\n"
+          "x-intellij-html-description": "Only multi-module"
         },
         "profile": {
           "type": "string"
@@ -763,7 +763,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a on-cluster build using the kaniko image",
-      "x-intellij-html-description": "<p>contains the fields needed to do a on-cluster build using the kaniko image</p>\n"
+      "x-intellij-html-description": "contains the fields needed to do a on-cluster build using the kaniko image"
     },
     "KanikoBuildContext": {
       "properties": {
@@ -780,7 +780,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the different fields available to specify a kaniko build context",
-      "x-intellij-html-description": "<p>contains the different fields available to specify a kaniko build context</p>\n"
+      "x-intellij-html-description": "contains the different fields available to specify a kaniko build context"
     },
     "KanikoCache": {
       "properties": {
@@ -793,7 +793,7 @@
       ],
       "additionalProperties": false,
       "description": "contains fields related to kaniko caching",
-      "x-intellij-html-description": "<p>contains fields related to kaniko caching</p>\n"
+      "x-intellij-html-description": "contains fields related to kaniko caching"
     },
     "KubectlDeploy": {
       "properties": {
@@ -822,7 +822,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with `kubectl apply`",
-      "x-intellij-html-description": "<p>contains the configuration needed for deploying with <code>kubectl apply</code></p>\n"
+      "x-intellij-html-description": "contains the configuration needed for deploying with <code>kubectl apply</code>"
     },
     "KubectlFlags": {
       "properties": {
@@ -855,7 +855,7 @@
       ],
       "additionalProperties": false,
       "description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).",
-      "x-intellij-html-description": "<p>describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).</p>\n"
+      "x-intellij-html-description": "describes additional options flags that are passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete)."
     },
     "KustomizeDeploy": {
       "properties": {
@@ -872,7 +872,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the configuration needed for deploying with kustomize.",
-      "x-intellij-html-description": "<p>contains the configuration needed for deploying with kustomize.</p>\n"
+      "x-intellij-html-description": "contains the configuration needed for deploying with kustomize."
     },
     "LocalBuild": {
       "properties": {
@@ -895,11 +895,11 @@
       ],
       "additionalProperties": false,
       "description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository.",
-      "x-intellij-html-description": "<p>contains the fields needed to do a build on the local docker daemon and optionally push to a repository.</p>\n"
+      "x-intellij-html-description": "contains the fields needed to do a build on the local docker daemon and optionally push to a repository."
     },
     "LocalDir": {
       "description": "represents the local directory kaniko build context",
-      "x-intellij-html-description": "<p>represents the local directory kaniko build context</p>\n"
+      "x-intellij-html-description": "represents the local directory kaniko build context"
     },
     "Profile": {
       "properties": {
@@ -933,11 +933,11 @@
       ],
       "additionalProperties": false,
       "description": "additional configuration that overrides default configuration when it is activated.",
-      "x-intellij-html-description": "<p>additional configuration that overrides default configuration when it is activated.</p>\n"
+      "x-intellij-html-description": "additional configuration that overrides default configuration when it is activated."
     },
     "ShaTagger": {
       "description": "contains the configuration for the SHA tagger.",
-      "x-intellij-html-description": "<p>contains the configuration for the SHA tagger.</p>\n"
+      "x-intellij-html-description": "contains the configuration for the SHA tagger."
     },
     "SkaffoldPipeline": {
       "properties": {
@@ -996,7 +996,7 @@
       ],
       "additionalProperties": false,
       "description": "contains all the configuration for the tagging step",
-      "x-intellij-html-description": "<p>contains all the configuration for the tagging step</p>\n"
+      "x-intellij-html-description": "contains all the configuration for the tagging step"
     },
     "TestCase": {
       "properties": {
@@ -1017,7 +1017,7 @@
       ],
       "additionalProperties": false,
       "description": "a struct containing all the specified test configuration for an image.",
-      "x-intellij-html-description": "<p>a struct containing all the specified test configuration for an image.</p>\n"
+      "x-intellij-html-description": "a struct containing all the specified test configuration for an image."
     },
     "TestConfig": {
       "items": {
diff --git a/docs/content/en/schemas/v1beta5.json b/docs/content/en/schemas/v1beta5.json
index 6a6cb957b1c..90274e8373f 100755
--- a/docs/content/en/schemas/v1beta5.json
+++ b/docs/content/en/schemas/v1beta5.json
@@ -12,7 +12,7 @@
         "command": {
           "type": "string",
           "description": "a Skaffold command for which the profile is auto-activated.",
-          "x-intellij-html-description": "<p>a Skaffold command for which the profile is auto-activated.</p>\n",
+          "x-intellij-html-description": "a Skaffold command for which the profile is auto-activated.",
           "examples": [
             "dev"
           ]
@@ -20,7 +20,7 @@
         "env": {
           "type": "string",
           "description": "a key=value pair. The profile is auto-activated if an Environment Variable `key` has value `value`.",
-          "x-intellij-html-description": "<p>a key=value pair. The profile is auto-activated if an Environment Variable <code>key</code> has value <code>value</code>.</p>\n",
+          "x-intellij-html-description": "a key=value pair. The profile is auto-activated if an Environment Variable <code>key</code> has value <code>value</code>.",
           "examples": [
             "ENV=production"
           ]
@@ -28,7 +28,7 @@
         "kubeContext": {
           "type": "string",
           "description": "a Kubernetes context for which the profile is auto-activated.",
-          "x-intellij-html-description": "<p>a Kubernetes context for which the profile is auto-activated.</p>\n",
+          "x-intellij-html-description": "a Kubernetes context for which the profile is auto-activated.",
           "examples": [
             "minikube"
           ]
@@ -41,7 +41,7 @@
       ],
       "additionalProperties": false,
       "description": "criteria by which a profile is auto-activated.",
-      "x-intellij-html-description": "<p>criteria by which a profile is auto-activated.</p>\n"
+      "x-intellij-html-description": "criteria by which a profile is auto-activated."
     },
     "Artifact": {
       "required": [
@@ -53,13 +53,13 @@
             "context": {
               "type": "string",
               "description": "directory where the artifact's sources are to be found.",
-              "x-intellij-html-description": "<p>directory where the artifact's sources are to be found.</p>\n",
+              "x-intellij-html-description": "directory where the artifact's sources are to be found.",
               "default": "."
             },
             "image": {
               "type": "string",
               "description": "name of the image to be built.",
-              "x-intellij-html-description": "<p>name of the image to be built.</p>\n",
+              "x-intellij-html-description": "name of the image to be built.",
               "examples": [
                 "gcr.io/k8s-skaffold/example"
               ]
@@ -67,7 +67,7 @@
             "plugin": {
               "$ref": "#/definitions/BuilderPlugin",
               "description": "plugin used to build this artifact.",
-              "x-intellij-html-description": "<p>plugin used to build this artifact.</p>\n"
+              "x-intellij-html-description": "plugin used to build this artifact."
             },
             "sync": {
               "additionalProperties": {
@@ -75,7 +75,7 @@
               },
               "type": "object",
               "description": "*alpha* local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
-              "x-intellij-html-description": "<p><em>alpha</em> local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.</p>\n",
+              "x-intellij-html-description": "<em>alpha</em> local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
               "default": "{}",
               "examples": [
                 "{\"*.py\": \".\", \"css/**/*.css\": \"app/css\"}"
@@ -95,18 +95,18 @@
             "context": {
               "type": "string",
               "description": "directory where the artifact's sources are to be found.",
-              "x-intellij-html-description": "<p>directory where the artifact's sources are to be found.</p>\n",
+              "x-intellij-html-description": "directory where the artifact's sources are to be found.",
               "default": "."
             },
             "docker": {
               "$ref": "#/definitions/DockerArtifact",
               "description": "*beta* describes an artifact built from a Dockerfile.",
-              "x-intellij-html-description": "<p><em>beta</em> describes an artifact built from a Dockerfile.</p>\n"
+              "x-intellij-html-description": "<em>beta</em> describes an artifact built from a Dockerfile."
             },
             "image": {
               "type": "string",
               "description": "name of the image to be built.",
-              "x-intellij-html-description": "<p>name of the image to be built.</p>\n",
+              "x-intellij-html-description": "name of the image to be built.",
               "examples": [
                 "gcr.io/k8s-skaffold/example"
               ]
@@ -114,7 +114,7 @@
             "plugin": {
               "$ref": "#/definitions/BuilderPlugin",
               "description": "plugin used to build this artifact.",
-              "x-intellij-html-description": "<p>plugin used to build this artifact.</p>\n"
+              "x-intellij-html-description": "plugin used to build this artifact."
             },
             "sync": {
               "additionalProperties": {
@@ -122,7 +122,7 @@
               },
               "type": "object",
               "description": "*alpha* local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
-              "x-intellij-html-description": "<p><em>alpha</em> local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.</p>\n",
+              "x-intellij-html-description": "<em>alpha</em> local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
               "default": "{}",
               "examples": [
                 "{\"*.py\": \".\", \"css/**/*.css\": \"app/css\"}"
@@ -143,18 +143,18 @@
             "bazel": {
               "$ref": "#/definitions/BazelArtifact",
               "description": "*beta* requires bazel CLI to be installed and the sources to contain [Bazel](https://bazel.build/) configuration files.",
-              "x-intellij-html-description": "<p><em>beta</em> requires bazel CLI to be installed and the sources to contain <a href=\"https://bazel.build/\">Bazel</a> configuration files.</p>\n"
+              "x-intellij-html-description": "<em>beta</em> requires bazel CLI to be installed and the sources to contain <a href=\"https://bazel.build/\">Bazel</a> configuration files."
             },
             "context": {
               "type": "string",
               "description": "directory where the artifact's sources are to be found.",
-              "x-intellij-html-description": "<p>directory where the artifact's sources are to be found.</p>\n",
+              "x-intellij-html-description": "directory where the artifact's sources are to be found.",
               "default": "."
             },
             "image": {
               "type": "string",
               "description": "name of the image to be built.",
-              "x-intellij-html-description": "<p>name of the image to be built.</p>\n",
+              "x-intellij-html-description": "name of the image to be built.",
               "examples": [
                 "gcr.io/k8s-skaffold/example"
               ]
@@ -162,7 +162,7 @@
             "plugin": {
               "$ref": "#/definitions/BuilderPlugin",
               "description": "plugin used to build this artifact.",
-              "x-intellij-html-description": "<p>plugin used to build this artifact.</p>\n"
+              "x-intellij-html-description": "plugin used to build this artifact."
             },
             "sync": {
               "additionalProperties": {
@@ -170,7 +170,7 @@
               },
               "type": "object",
               "description": "*alpha* local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
-              "x-intellij-html-description": "<p><em>alpha</em> local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.</p>\n",
+              "x-intellij-html-description": "<em>alpha</em> local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
               "default": "{}",
               "examples": [
                 "{\"*.py\": \".\", \"css/**/*.css\": \"app/css\"}"
@@ -191,13 +191,13 @@
             "context": {
               "type": "string",
               "description": "directory where the artifact's sources are to be found.",
-              "x-intellij-html-description": "<p>directory where the artifact's sources are to be found.</p>\n",
+              "x-intellij-html-description": "directory where the artifact's sources are to be found.",
               "default": "."
             },
             "image": {
               "type": "string",
               "description": "name of the image to be built.",
-              "x-intellij-html-description": "<p>name of the image to be built.</p>\n",
+              "x-intellij-html-description": "name of the image to be built.",
               "examples": [
                 "gcr.io/k8s-skaffold/example"
               ]
@@ -205,12 +205,12 @@
             "jibMaven": {
               "$ref": "#/definitions/JibMavenArtifact",
               "description": "*alpha* builds images using the [Jib plugin for Maven](https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin).",
-              "x-intellij-html-description": "<p><em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin\">Jib plugin for Maven</a>.</p>\n"
+              "x-intellij-html-description": "<em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin\">Jib plugin for Maven</a>."
             },
             "plugin": {
               "$ref": "#/definitions/BuilderPlugin",
               "description": "plugin used to build this artifact.",
-              "x-intellij-html-description": "<p>plugin used to build this artifact.</p>\n"
+              "x-intellij-html-description": "plugin used to build this artifact."
             },
             "sync": {
               "additionalProperties": {
@@ -218,7 +218,7 @@
               },
               "type": "object",
               "description": "*alpha* local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
-              "x-intellij-html-description": "<p><em>alpha</em> local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.</p>\n",
+              "x-intellij-html-description": "<em>alpha</em> local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
               "default": "{}",
               "examples": [
                 "{\"*.py\": \".\", \"css/**/*.css\": \"app/css\"}"
@@ -239,13 +239,13 @@
             "context": {
               "type": "string",
               "description": "directory where the artifact's sources are to be found.",
-              "x-intellij-html-description": "<p>directory where the artifact's sources are to be found.</p>\n",
+              "x-intellij-html-description": "directory where the artifact's sources are to be found.",
               "default": "."
             },
             "image": {
               "type": "string",
               "description": "name of the image to be built.",
-              "x-intellij-html-description": "<p>name of the image to be built.</p>\n",
+              "x-intellij-html-description": "name of the image to be built.",
               "examples": [
                 "gcr.io/k8s-skaffold/example"
               ]
@@ -253,12 +253,12 @@
             "jibGradle": {
               "$ref": "#/definitions/JibGradleArtifact",
               "description": "*alpha* builds images using the [Jib plugin for Gradle](https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin).",
-              "x-intellij-html-description": "<p><em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin\">Jib plugin for Gradle</a>.</p>\n"
+              "x-intellij-html-description": "<em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin\">Jib plugin for Gradle</a>."
             },
             "plugin": {
               "$ref": "#/definitions/BuilderPlugin",
               "description": "plugin used to build this artifact.",
-              "x-intellij-html-description": "<p>plugin used to build this artifact.</p>\n"
+              "x-intellij-html-description": "plugin used to build this artifact."
             },
             "sync": {
               "additionalProperties": {
@@ -266,7 +266,7 @@
               },
               "type": "object",
               "description": "*alpha* local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
-              "x-intellij-html-description": "<p><em>alpha</em> local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.</p>\n",
+              "x-intellij-html-description": "<em>alpha</em> local files that can be synced to remote pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
               "default": "{}",
               "examples": [
                 "{\"*.py\": \".\", \"css/**/*.css\": \"app/css\"}"
@@ -284,29 +284,29 @@
         }
       ],
       "description": "items that need to be built, along with the context in which they should be built.",
-      "x-intellij-html-description": "<p>items that need to be built, along with the context in which they should be built.</p>\n"
+      "x-intellij-html-description": "items that need to be built, along with the context in which they should be built."
     },
     "ArtifactType": {
       "properties": {
         "bazel": {
           "$ref": "#/definitions/BazelArtifact",
           "description": "*beta* requires bazel CLI to be installed and the sources to contain [Bazel](https://bazel.build/) configuration files.",
-          "x-intellij-html-description": "<p><em>beta</em> requires bazel CLI to be installed and the sources to contain <a href=\"https://bazel.build/\">Bazel</a> configuration files.</p>\n"
+          "x-intellij-html-description": "<em>beta</em> requires bazel CLI to be installed and the sources to contain <a href=\"https://bazel.build/\">Bazel</a> configuration files."
         },
         "docker": {
           "$ref": "#/definitions/DockerArtifact",
           "description": "*beta* describes an artifact built from a Dockerfile.",
-          "x-intellij-html-description": "<p><em>beta</em> describes an artifact built from a Dockerfile.</p>\n"
+          "x-intellij-html-description": "<em>beta</em> describes an artifact built from a Dockerfile."
         },
         "jibGradle": {
           "$ref": "#/definitions/JibGradleArtifact",
           "description": "*alpha* builds images using the [Jib plugin for Gradle](https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin).",
-          "x-intellij-html-description": "<p><em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin\">Jib plugin for Gradle</a>.</p>\n"
+          "x-intellij-html-description": "<em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin\">Jib plugin for Gradle</a>."
         },
         "jibMaven": {
           "$ref": "#/definitions/JibMavenArtifact",
           "description": "*alpha* builds images using the [Jib plugin for Maven](https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin).",
-          "x-intellij-html-description": "<p><em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin\">Jib plugin for Maven</a>.</p>\n"
+          "x-intellij-html-description": "<em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin\">Jib plugin for Maven</a>."
         }
       },
       "preferredOrder": [
@@ -328,7 +328,7 @@
           },
           "type": "array",
           "description": "additional args to pass to `bazel build`.",
-          "x-intellij-html-description": "<p>additional args to pass to <code>bazel build</code>.</p>\n",
+          "x-intellij-html-description": "additional args to pass to <code>bazel build</code>.",
           "default": "[]",
           "examples": [
             "[\"-flag\", \"--otherflag\"]"
@@ -337,7 +337,7 @@
         "target": {
           "type": "string",
           "description": "`bazel build` target to run.",
-          "x-intellij-html-description": "<p><code>bazel build</code> target to run.</p>\n",
+          "x-intellij-html-description": "<code>bazel build</code> target to run.",
           "examples": [
             "//:skaffold_example.tar"
           ]
@@ -349,7 +349,7 @@
       ],
       "additionalProperties": false,
       "description": "*beta* describes an artifact built with [Bazel](https://bazel.build/).",
-      "x-intellij-html-description": "<p><em>beta</em> describes an artifact built with <a href=\"https://bazel.build/\">Bazel</a>.</p>\n"
+      "x-intellij-html-description": "<em>beta</em> describes an artifact built with <a href=\"https://bazel.build/\">Bazel</a>."
     },
     "BuildConfig": {
       "anyOf": [
@@ -361,17 +361,17 @@
               },
               "type": "array",
               "description": "the images you're going to be building.",
-              "x-intellij-html-description": "<p>the images you're going to be building.</p>\n"
+              "x-intellij-html-description": "the images you're going to be building."
             },
             "executionEnvironment": {
               "$ref": "#/definitions/ExecutionEnvironment",
               "description": "environment in which the build should run. Possible values: googleCloudBuild.",
-              "x-intellij-html-description": "<p>environment in which the build should run. Possible values: googleCloudBuild.</p>\n"
+              "x-intellij-html-description": "environment in which the build should run. Possible values: googleCloudBuild."
             },
             "tagPolicy": {
               "$ref": "#/definitions/TagPolicy",
               "description": "*beta* determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to `gitCommit: {}`.",
-              "x-intellij-html-description": "<p><em>beta</em> determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>.</p>\n"
+              "x-intellij-html-description": "<em>beta</em> determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>."
             }
           },
           "preferredOrder": [
@@ -389,22 +389,22 @@
               },
               "type": "array",
               "description": "the images you're going to be building.",
-              "x-intellij-html-description": "<p>the images you're going to be building.</p>\n"
+              "x-intellij-html-description": "the images you're going to be building."
             },
             "executionEnvironment": {
               "$ref": "#/definitions/ExecutionEnvironment",
               "description": "environment in which the build should run. Possible values: googleCloudBuild.",
-              "x-intellij-html-description": "<p>environment in which the build should run. Possible values: googleCloudBuild.</p>\n"
+              "x-intellij-html-description": "environment in which the build should run. Possible values: googleCloudBuild."
             },
             "local": {
               "$ref": "#/definitions/LocalBuild",
               "description": "*beta* describes how to do a build on the local docker daemon and optionally push to a repository.",
-              "x-intellij-html-description": "<p><em>beta</em> describes how to do a build on the local docker daemon and optionally push to a repository.</p>\n"
+              "x-intellij-html-description": "<em>beta</em> describes how to do a build on the local docker daemon and optionally push to a repository."
             },
             "tagPolicy": {
               "$ref": "#/definitions/TagPolicy",
               "description": "*beta* determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to `gitCommit: {}`.",
-              "x-intellij-html-description": "<p><em>beta</em> determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>.</p>\n"
+              "x-intellij-html-description": "<em>beta</em> determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>."
             }
           },
           "preferredOrder": [
@@ -423,22 +423,22 @@
               },
               "type": "array",
               "description": "the images you're going to be building.",
-              "x-intellij-html-description": "<p>the images you're going to be building.</p>\n"
+              "x-intellij-html-description": "the images you're going to be building."
             },
             "executionEnvironment": {
               "$ref": "#/definitions/ExecutionEnvironment",
               "description": "environment in which the build should run. Possible values: googleCloudBuild.",
-              "x-intellij-html-description": "<p>environment in which the build should run. Possible values: googleCloudBuild.</p>\n"
+              "x-intellij-html-description": "environment in which the build should run. Possible values: googleCloudBuild."
             },
             "googleCloudBuild": {
               "$ref": "#/definitions/GoogleCloudBuild",
               "description": "*beta* describes how to do a remote build on [Google Cloud Build](https://cloud.google.com/cloud-build/).",
-              "x-intellij-html-description": "<p><em>beta</em> describes how to do a remote build on <a href=\"https://cloud.google.com/cloud-build/\">Google Cloud Build</a>.</p>\n"
+              "x-intellij-html-description": "<em>beta</em> describes how to do a remote build on <a href=\"https://cloud.google.com/cloud-build/\">Google Cloud Build</a>."
             },
             "tagPolicy": {
               "$ref": "#/definitions/TagPolicy",
               "description": "*beta* determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to `gitCommit: {}`.",
-              "x-intellij-html-description": "<p><em>beta</em> determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>.</p>\n"
+              "x-intellij-html-description": "<em>beta</em> determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>."
             }
           },
           "preferredOrder": [
@@ -457,22 +457,22 @@
               },
               "type": "array",
               "description": "the images you're going to be building.",
-              "x-intellij-html-description": "<p>the images you're going to be building.</p>\n"
+              "x-intellij-html-description": "the images you're going to be building."
             },
             "executionEnvironment": {
               "$ref": "#/definitions/ExecutionEnvironment",
               "description": "environment in which the build should run. Possible values: googleCloudBuild.",
-              "x-intellij-html-description": "<p>environment in which the build should run. Possible values: googleCloudBuild.</p>\n"
+              "x-intellij-html-description": "environment in which the build should run. Possible values: googleCloudBuild."
             },
             "kaniko": {
               "$ref": "#/definitions/KanikoBuild",
               "description": "*beta* describes how to do an on-cluster build using [Kaniko](https://github.com/GoogleContainerTools/kaniko).",
-              "x-intellij-html-description": "<p><em>beta</em> describes how to do an on-cluster build using <a href=\"https://github.com/GoogleContainerTools/kaniko\">Kaniko</a>.</p>\n"
+              "x-intellij-html-description": "<em>beta</em> describes how to do an on-cluster build using <a href=\"https://github.com/GoogleContainerTools/kaniko\">Kaniko</a>."
             },
             "tagPolicy": {
               "$ref": "#/definitions/TagPolicy",
               "description": "*beta* determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to `gitCommit: {}`.",
-              "x-intellij-html-description": "<p><em>beta</em> determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>.</p>\n"
+              "x-intellij-html-description": "<em>beta</em> determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>."
             }
           },
           "preferredOrder": [
@@ -485,24 +485,24 @@
         }
       ],
       "description": "contains all the configuration for the build steps.",
-      "x-intellij-html-description": "<p>contains all the configuration for the build steps.</p>\n"
+      "x-intellij-html-description": "contains all the configuration for the build steps."
     },
     "BuildType": {
       "properties": {
         "googleCloudBuild": {
           "$ref": "#/definitions/GoogleCloudBuild",
           "description": "*beta* describes how to do a remote build on [Google Cloud Build](https://cloud.google.com/cloud-build/).",
-          "x-intellij-html-description": "<p><em>beta</em> describes how to do a remote build on <a href=\"https://cloud.google.com/cloud-build/\">Google Cloud Build</a>.</p>\n"
+          "x-intellij-html-description": "<em>beta</em> describes how to do a remote build on <a href=\"https://cloud.google.com/cloud-build/\">Google Cloud Build</a>."
         },
         "kaniko": {
           "$ref": "#/definitions/KanikoBuild",
           "description": "*beta* describes how to do an on-cluster build using [Kaniko](https://github.com/GoogleContainerTools/kaniko).",
-          "x-intellij-html-description": "<p><em>beta</em> describes how to do an on-cluster build using <a href=\"https://github.com/GoogleContainerTools/kaniko\">Kaniko</a>.</p>\n"
+          "x-intellij-html-description": "<em>beta</em> describes how to do an on-cluster build using <a href=\"https://github.com/GoogleContainerTools/kaniko\">Kaniko</a>."
         },
         "local": {
           "$ref": "#/definitions/LocalBuild",
           "description": "*beta* describes how to do a build on the local docker daemon and optionally push to a repository.",
-          "x-intellij-html-description": "<p><em>beta</em> describes how to do a build on the local docker daemon and optionally push to a repository.</p>\n"
+          "x-intellij-html-description": "<em>beta</em> describes how to do a build on the local docker daemon and optionally push to a repository."
         }
       },
       "preferredOrder": [
@@ -512,20 +512,20 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.",
-      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the build step. Only one field should be populated.</p>\n"
+      "x-intellij-html-description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated."
     },
     "BuilderPlugin": {
       "properties": {
         "name": {
           "type": "string",
           "description": "name of the build plugin.",
-          "x-intellij-html-description": "<p>name of the build plugin.</p>\n"
+          "x-intellij-html-description": "name of the build plugin."
         },
         "properties": {
           "additionalProperties": {},
           "type": "object",
           "description": "key-value pairs passed to the plugin.",
-          "x-intellij-html-description": "<p>key-value pairs passed to the plugin.</p>\n",
+          "x-intellij-html-description": "key-value pairs passed to the plugin.",
           "default": "{}"
         }
       },
@@ -535,20 +535,20 @@
       ],
       "additionalProperties": false,
       "description": "contains all fields necessary for specifying a build plugin.",
-      "x-intellij-html-description": "<p>contains all fields necessary for specifying a build plugin.</p>\n"
+      "x-intellij-html-description": "contains all fields necessary for specifying a build plugin."
     },
     "DateTimeTagger": {
       "properties": {
         "format": {
           "type": "string",
           "description": "formats the date and time. See [#Time.Format](https://golang.org/pkg/time/#Time.Format).",
-          "x-intellij-html-description": "<p>formats the date and time. See <a href=\"https://golang.org/pkg/time/#Time.Format\">#Time.Format</a>.</p>\n",
+          "x-intellij-html-description": "formats the date and time. See <a href=\"https://golang.org/pkg/time/#Time.Format\">#Time.Format</a>.",
           "default": "2006-01-02_15-04-05.999_MST"
         },
         "timezone": {
           "type": "string",
           "description": "sets the timezone for the date and time. See [Time.LoadLocation](https://golang.org/pkg/time/#Time.LoadLocation). Defaults to the local timezone.",
-          "x-intellij-html-description": "<p>sets the timezone for the date and time. See <a href=\"https://golang.org/pkg/time/#Time.LoadLocation\">Time.LoadLocation</a>. Defaults to the local timezone.</p>\n"
+          "x-intellij-html-description": "sets the timezone for the date and time. See <a href=\"https://golang.org/pkg/time/#Time.LoadLocation\">Time.LoadLocation</a>. Defaults to the local timezone."
         }
       },
       "preferredOrder": [
@@ -557,7 +557,7 @@
       ],
       "additionalProperties": false,
       "description": "*beta* tags images with the build timestamp.",
-      "x-intellij-html-description": "<p><em>beta</em> tags images with the build timestamp.</p>\n"
+      "x-intellij-html-description": "<em>beta</em> tags images with the build timestamp."
     },
     "DeployConfig": {
       "anyOf": [
@@ -569,7 +569,7 @@
             "helm": {
               "$ref": "#/definitions/HelmDeploy",
               "description": "*beta* uses the `helm` CLI to apply the charts to the cluster.",
-              "x-intellij-html-description": "<p><em>beta</em> uses the <code>helm</code> CLI to apply the charts to the cluster.</p>\n"
+              "x-intellij-html-description": "<em>beta</em> uses the <code>helm</code> CLI to apply the charts to the cluster."
             }
           },
           "preferredOrder": [
@@ -582,7 +582,7 @@
             "kubectl": {
               "$ref": "#/definitions/KubectlDeploy",
               "description": "*beta* uses a client side `kubectl apply` to deploy manifests. You'll need a `kubectl` CLI version installed that's compatible with your cluster.",
-              "x-intellij-html-description": "<p><em>beta</em> uses a client side <code>kubectl apply</code> to deploy manifests. You'll need a <code>kubectl</code> CLI version installed that's compatible with your cluster.</p>\n"
+              "x-intellij-html-description": "<em>beta</em> uses a client side <code>kubectl apply</code> to deploy manifests. You'll need a <code>kubectl</code> CLI version installed that's compatible with your cluster."
             }
           },
           "preferredOrder": [
@@ -595,7 +595,7 @@
             "kustomize": {
               "$ref": "#/definitions/KustomizeDeploy",
               "description": "*beta* uses the `kustomize` CLI to \"patch\" a deployment for a target environment.",
-              "x-intellij-html-description": "<p><em>beta</em> uses the <code>kustomize</code> CLI to &quot;patch&quot; a deployment for a target environment.</p>\n"
+              "x-intellij-html-description": "<em>beta</em> uses the <code>kustomize</code> CLI to &quot;patch&quot; a deployment for a target environment."
             }
           },
           "preferredOrder": [
@@ -605,24 +605,24 @@
         }
       ],
       "description": "contains all the configuration needed by the deploy steps.",
-      "x-intellij-html-description": "<p>contains all the configuration needed by the deploy steps.</p>\n"
+      "x-intellij-html-description": "contains all the configuration needed by the deploy steps."
     },
     "DeployType": {
       "properties": {
         "helm": {
           "$ref": "#/definitions/HelmDeploy",
           "description": "*beta* uses the `helm` CLI to apply the charts to the cluster.",
-          "x-intellij-html-description": "<p><em>beta</em> uses the <code>helm</code> CLI to apply the charts to the cluster.</p>\n"
+          "x-intellij-html-description": "<em>beta</em> uses the <code>helm</code> CLI to apply the charts to the cluster."
         },
         "kubectl": {
           "$ref": "#/definitions/KubectlDeploy",
           "description": "*beta* uses a client side `kubectl apply` to deploy manifests. You'll need a `kubectl` CLI version installed that's compatible with your cluster.",
-          "x-intellij-html-description": "<p><em>beta</em> uses a client side <code>kubectl apply</code> to deploy manifests. You'll need a <code>kubectl</code> CLI version installed that's compatible with your cluster.</p>\n"
+          "x-intellij-html-description": "<em>beta</em> uses a client side <code>kubectl apply</code> to deploy manifests. You'll need a <code>kubectl</code> CLI version installed that's compatible with your cluster."
         },
         "kustomize": {
           "$ref": "#/definitions/KustomizeDeploy",
           "description": "*beta* uses the `kustomize` CLI to \"patch\" a deployment for a target environment.",
-          "x-intellij-html-description": "<p><em>beta</em> uses the <code>kustomize</code> CLI to &quot;patch&quot; a deployment for a target environment.</p>\n"
+          "x-intellij-html-description": "<em>beta</em> uses the <code>kustomize</code> CLI to &quot;patch&quot; a deployment for a target environment."
         }
       },
       "preferredOrder": [
@@ -632,7 +632,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.",
-      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.</p>\n"
+      "x-intellij-html-description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated."
     },
     "DockerArtifact": {
       "properties": {
@@ -642,7 +642,7 @@
           },
           "type": "object",
           "description": "arguments passed to the docker build.",
-          "x-intellij-html-description": "<p>arguments passed to the docker build.</p>\n",
+          "x-intellij-html-description": "arguments passed to the docker build.",
           "default": "{}",
           "examples": [
             "{\"key1\": \"value1\", \"key2\": \"value2\"}"
@@ -654,7 +654,7 @@
           },
           "type": "array",
           "description": "the Docker images to consider as cache sources.",
-          "x-intellij-html-description": "<p>the Docker images to consider as cache sources.</p>\n",
+          "x-intellij-html-description": "the Docker images to consider as cache sources.",
           "default": "[]",
           "examples": [
             "[\"golang:1.10.1-alpine3.7\", \"alpine:3.7\"]"
@@ -663,13 +663,13 @@
         "dockerfile": {
           "type": "string",
           "description": "locates the Dockerfile relative to workspace.",
-          "x-intellij-html-description": "<p>locates the Dockerfile relative to workspace.</p>\n",
+          "x-intellij-html-description": "locates the Dockerfile relative to workspace.",
           "default": "Dockerfile"
         },
         "target": {
           "type": "string",
           "description": "Dockerfile target name to build.",
-          "x-intellij-html-description": "<p>Dockerfile target name to build.</p>\n"
+          "x-intellij-html-description": "Dockerfile target name to build."
         }
       },
       "preferredOrder": [
@@ -680,19 +680,19 @@
       ],
       "additionalProperties": false,
       "description": "*beta* describes an artifact built from a Dockerfile, usually using `docker build`.",
-      "x-intellij-html-description": "<p><em>beta</em> describes an artifact built from a Dockerfile, usually using <code>docker build</code>.</p>\n"
+      "x-intellij-html-description": "<em>beta</em> describes an artifact built from a Dockerfile, usually using <code>docker build</code>."
     },
     "DockerConfig": {
       "properties": {
         "path": {
           "type": "string",
           "description": "path to the docker `config.json`.",
-          "x-intellij-html-description": "<p>path to the docker <code>config.json</code>.</p>\n"
+          "x-intellij-html-description": "path to the docker <code>config.json</code>."
         },
         "secretName": {
           "type": "string",
           "description": "Kubernetes secret that will hold the Docker configuration.",
-          "x-intellij-html-description": "<p>Kubernetes secret that will hold the Docker configuration.</p>\n"
+          "x-intellij-html-description": "Kubernetes secret that will hold the Docker configuration."
         }
       },
       "preferredOrder": [
@@ -701,7 +701,7 @@
       ],
       "additionalProperties": false,
       "description": "contains information about the docker `config.json` to mount.",
-      "x-intellij-html-description": "<p>contains information about the docker <code>config.json</code> to mount.</p>\n"
+      "x-intellij-html-description": "contains information about the docker <code>config.json</code> to mount."
     },
     "EnvTemplateTagger": {
       "required": [
@@ -711,7 +711,7 @@
         "template": {
           "type": "string",
           "description": "used to produce the image name and tag. See golang [text/template](https://golang.org/pkg/text/template/). The template is executed against the current environment, with those variables injected:   IMAGE_NAME   |  Name of the image being built, as supplied in the artifacts section.",
-          "x-intellij-html-description": "<p>used to produce the image name and tag. See golang <a href=\"https://golang.org/pkg/text/template/\">text/template</a>. The template is executed against the current environment, with those variables injected:   IMAGE_NAME   |  Name of the image being built, as supplied in the artifacts section.</p>\n",
+          "x-intellij-html-description": "used to produce the image name and tag. See golang <a href=\"https://golang.org/pkg/text/template/\">text/template</a>. The template is executed against the current environment, with those variables injected:   IMAGE_NAME   |  Name of the image being built, as supplied in the artifacts section.",
           "examples": [
             "{{.RELEASE}}-{{.IMAGE_NAME}}"
           ]
@@ -722,7 +722,7 @@
       ],
       "additionalProperties": false,
       "description": "*beta* tags images with a configurable template string.",
-      "x-intellij-html-description": "<p><em>beta</em> tags images with a configurable template string.</p>\n"
+      "x-intellij-html-description": "<em>beta</em> tags images with a configurable template string."
     },
     "ExecEnvironment": {
       "type": "string"
@@ -732,13 +732,13 @@
         "name": {
           "$ref": "#/definitions/ExecEnvironment",
           "description": "name of the environment.",
-          "x-intellij-html-description": "<p>name of the environment.</p>\n"
+          "x-intellij-html-description": "name of the environment."
         },
         "properties": {
           "additionalProperties": {},
           "type": "object",
           "description": "key-value pairs passed to the environment.",
-          "x-intellij-html-description": "<p>key-value pairs passed to the environment.</p>\n",
+          "x-intellij-html-description": "key-value pairs passed to the environment.",
           "default": "{}"
         }
       },
@@ -748,51 +748,51 @@
       ],
       "additionalProperties": false,
       "description": "environment in which the build should run (ex. local or in-cluster, etc.).",
-      "x-intellij-html-description": "<p>environment in which the build should run (ex. local or in-cluster, etc.).</p>\n"
+      "x-intellij-html-description": "environment in which the build should run (ex. local or in-cluster, etc.)."
     },
     "GitTagger": {
       "description": "*beta* tags images with the git tag or commit of the artifact's workspace.",
-      "x-intellij-html-description": "<p><em>beta</em> tags images with the git tag or commit of the artifact's workspace.</p>\n"
+      "x-intellij-html-description": "<em>beta</em> tags images with the git tag or commit of the artifact's workspace."
     },
     "GoogleCloudBuild": {
       "properties": {
         "diskSizeGb": {
           "type": "number",
           "description": "disk size of the VM that runs the build. See [Cloud Build Reference](https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#buildoptions).",
-          "x-intellij-html-description": "<p>disk size of the VM that runs the build. See <a href=\"https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#buildoptions\">Cloud Build Reference</a>.</p>\n"
+          "x-intellij-html-description": "disk size of the VM that runs the build. See <a href=\"https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#buildoptions\">Cloud Build Reference</a>."
         },
         "dockerImage": {
           "type": "string",
           "description": "image that runs a Docker build. See [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders).",
-          "x-intellij-html-description": "<p>image that runs a Docker build. See <a href=\"https://cloud.google.com/cloud-build/docs/cloud-builders\">Cloud Builders</a>.</p>\n",
+          "x-intellij-html-description": "image that runs a Docker build. See <a href=\"https://cloud.google.com/cloud-build/docs/cloud-builders\">Cloud Builders</a>.",
           "default": "gcr.io/cloud-builders/docker"
         },
         "gradleImage": {
           "type": "string",
           "description": "image that runs a Gradle build. See [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders).",
-          "x-intellij-html-description": "<p>image that runs a Gradle build. See <a href=\"https://cloud.google.com/cloud-build/docs/cloud-builders\">Cloud Builders</a>.</p>\n",
+          "x-intellij-html-description": "image that runs a Gradle build. See <a href=\"https://cloud.google.com/cloud-build/docs/cloud-builders\">Cloud Builders</a>.",
           "default": "gcr.io/cloud-builders/gradle"
         },
         "machineType": {
           "type": "string",
           "description": "type of the VM that runs the build. See [Cloud Build Reference](https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#buildoptions).",
-          "x-intellij-html-description": "<p>type of the VM that runs the build. See <a href=\"https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#buildoptions\">Cloud Build Reference</a>.</p>\n"
+          "x-intellij-html-description": "type of the VM that runs the build. See <a href=\"https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#buildoptions\">Cloud Build Reference</a>."
         },
         "mavenImage": {
           "type": "string",
           "description": "image that runs a Maven build. See [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders).",
-          "x-intellij-html-description": "<p>image that runs a Maven build. See <a href=\"https://cloud.google.com/cloud-build/docs/cloud-builders\">Cloud Builders</a>.</p>\n",
+          "x-intellij-html-description": "image that runs a Maven build. See <a href=\"https://cloud.google.com/cloud-build/docs/cloud-builders\">Cloud Builders</a>.",
           "default": "gcr.io/cloud-builders/mvn"
         },
         "projectId": {
           "type": "string",
           "description": "ID of your Cloud Platform Project. If it is not provided, Skaffold will guess it from the image name. For example, given the artifact image name `gcr.io/myproject/image`, Skaffold will use the `myproject` GCP project.",
-          "x-intellij-html-description": "<p>ID of your Cloud Platform Project. If it is not provided, Skaffold will guess it from the image name. For example, given the artifact image name <code>gcr.io/myproject/image</code>, Skaffold will use the <code>myproject</code> GCP project.</p>\n"
+          "x-intellij-html-description": "ID of your Cloud Platform Project. If it is not provided, Skaffold will guess it from the image name. For example, given the artifact image name <code>gcr.io/myproject/image</code>, Skaffold will use the <code>myproject</code> GCP project."
         },
         "timeout": {
           "type": "string",
           "description": "amount of time (in seconds) that this build should be allowed to run. See [Cloud Build Reference](https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#resource-build).",
-          "x-intellij-html-description": "<p>amount of time (in seconds) that this build should be allowed to run. See <a href=\"https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#resource-build\">Cloud Build Reference</a>.</p>\n"
+          "x-intellij-html-description": "amount of time (in seconds) that this build should be allowed to run. See <a href=\"https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#resource-build\">Cloud Build Reference</a>."
         }
       },
       "preferredOrder": [
@@ -806,11 +806,11 @@
       ],
       "additionalProperties": false,
       "description": "*beta* describes how to do a remote build on [Google Cloud Build](https://cloud.google.com/cloud-build/docs/). Docker and Jib artifacts can be built on Cloud Build. The `projectId` needs to be provided and the currently logged in user should be given permissions to trigger new builds.",
-      "x-intellij-html-description": "<p><em>beta</em> describes how to do a remote build on <a href=\"https://cloud.google.com/cloud-build/docs/\">Google Cloud Build</a>. Docker and Jib artifacts can be built on Cloud Build. The <code>projectId</code> needs to be provided and the currently logged in user should be given permissions to trigger new builds.</p>\n"
+      "x-intellij-html-description": "<em>beta</em> describes how to do a remote build on <a href=\"https://cloud.google.com/cloud-build/docs/\">Google Cloud Build</a>. Docker and Jib artifacts can be built on Cloud Build. The <code>projectId</code> needs to be provided and the currently logged in user should be given permissions to trigger new builds."
     },
     "HelmConventionConfig": {
       "description": "image config in the syntax of image.repository and image.tag.",
-      "x-intellij-html-description": "<p>image config in the syntax of image.repository and image.tag.</p>\n"
+      "x-intellij-html-description": "image config in the syntax of image.repository and image.tag."
     },
     "HelmDeploy": {
       "required": [
@@ -823,7 +823,7 @@
           },
           "type": "array",
           "description": "a list of Helm releases.",
-          "x-intellij-html-description": "<p>a list of Helm releases.</p>\n"
+          "x-intellij-html-description": "a list of Helm releases."
         }
       },
       "preferredOrder": [
@@ -831,14 +831,14 @@
       ],
       "additionalProperties": false,
       "description": "*beta* uses the `helm` CLI to apply the charts to the cluster.",
-      "x-intellij-html-description": "<p><em>beta</em> uses the <code>helm</code> CLI to apply the charts to the cluster.</p>\n"
+      "x-intellij-html-description": "<em>beta</em> uses the <code>helm</code> CLI to apply the charts to the cluster."
     },
     "HelmFQNConfig": {
       "properties": {
         "property": {
           "type": "string",
           "description": "defines the image config.",
-          "x-intellij-html-description": "<p>defines the image config.</p>\n"
+          "x-intellij-html-description": "defines the image config."
         }
       },
       "preferredOrder": [
@@ -846,19 +846,19 @@
       ],
       "additionalProperties": false,
       "description": "image config to use the FullyQualifiedImageName as param to set.",
-      "x-intellij-html-description": "<p>image config to use the FullyQualifiedImageName as param to set.</p>\n"
+      "x-intellij-html-description": "image config to use the FullyQualifiedImageName as param to set."
     },
     "HelmImageConfig": {
       "properties": {
         "fqn": {
           "$ref": "#/definitions/HelmFQNConfig",
           "description": "image configuration uses the syntax `IMAGE-NAME=IMAGE-REPOSITORY:IMAGE-TAG`.",
-          "x-intellij-html-description": "<p>image configuration uses the syntax <code>IMAGE-NAME=IMAGE-REPOSITORY:IMAGE-TAG</code>.</p>\n"
+          "x-intellij-html-description": "image configuration uses the syntax <code>IMAGE-NAME=IMAGE-REPOSITORY:IMAGE-TAG</code>."
         },
         "helm": {
           "$ref": "#/definitions/HelmConventionConfig",
           "description": "image configuration uses the syntax `IMAGE-NAME.repository=IMAGE-REPOSITORY, IMAGE-NAME.tag=IMAGE-TAG`.",
-          "x-intellij-html-description": "<p>image configuration uses the syntax <code>IMAGE-NAME.repository=IMAGE-REPOSITORY, IMAGE-NAME.tag=IMAGE-TAG</code>.</p>\n"
+          "x-intellij-html-description": "image configuration uses the syntax <code>IMAGE-NAME.repository=IMAGE-REPOSITORY, IMAGE-NAME.tag=IMAGE-TAG</code>."
         }
       },
       "preferredOrder": [
@@ -877,7 +877,7 @@
             "fqn": {
               "$ref": "#/definitions/HelmFQNConfig",
               "description": "image configuration uses the syntax `IMAGE-NAME=IMAGE-REPOSITORY:IMAGE-TAG`.",
-              "x-intellij-html-description": "<p>image configuration uses the syntax <code>IMAGE-NAME=IMAGE-REPOSITORY:IMAGE-TAG</code>.</p>\n"
+              "x-intellij-html-description": "image configuration uses the syntax <code>IMAGE-NAME=IMAGE-REPOSITORY:IMAGE-TAG</code>."
             }
           },
           "preferredOrder": [
@@ -890,7 +890,7 @@
             "helm": {
               "$ref": "#/definitions/HelmConventionConfig",
               "description": "image configuration uses the syntax `IMAGE-NAME.repository=IMAGE-REPOSITORY, IMAGE-NAME.tag=IMAGE-TAG`.",
-              "x-intellij-html-description": "<p>image configuration uses the syntax <code>IMAGE-NAME.repository=IMAGE-REPOSITORY, IMAGE-NAME.tag=IMAGE-TAG</code>.</p>\n"
+              "x-intellij-html-description": "image configuration uses the syntax <code>IMAGE-NAME.repository=IMAGE-REPOSITORY, IMAGE-NAME.tag=IMAGE-TAG</code>."
             }
           },
           "preferredOrder": [
@@ -900,19 +900,19 @@
         }
       ],
       "description": "adds image configurations to the Helm `values` file.",
-      "x-intellij-html-description": "<p>adds image configurations to the Helm <code>values</code> file.</p>\n"
+      "x-intellij-html-description": "adds image configurations to the Helm <code>values</code> file."
     },
     "HelmPackaged": {
       "properties": {
         "appVersion": {
           "type": "string",
           "description": "sets the `appVersion` on the chart to this version.",
-          "x-intellij-html-description": "<p>sets the <code>appVersion</code> on the chart to this version.</p>\n"
+          "x-intellij-html-description": "sets the <code>appVersion</code> on the chart to this version."
         },
         "version": {
           "type": "string",
           "description": "sets the `version` on the chart to this semver version.",
-          "x-intellij-html-description": "<p>sets the <code>version</code> on the chart to this semver version.</p>\n"
+          "x-intellij-html-description": "sets the <code>version</code> on the chart to this semver version."
         }
       },
       "preferredOrder": [
@@ -921,7 +921,7 @@
       ],
       "additionalProperties": false,
       "description": "parameters for packaging helm chart (`helm package`).",
-      "x-intellij-html-description": "<p>parameters for packaging helm chart (<code>helm package</code>).</p>\n"
+      "x-intellij-html-description": "parameters for packaging helm chart (<code>helm package</code>)."
     },
     "HelmRelease": {
       "required": [
@@ -932,39 +932,39 @@
         "chartPath": {
           "type": "string",
           "description": "path to the Helm chart.",
-          "x-intellij-html-description": "<p>path to the Helm chart.</p>\n"
+          "x-intellij-html-description": "path to the Helm chart."
         },
         "imageStrategy": {
           "$ref": "#/definitions/HelmImageStrategy",
           "description": "adds image configurations to the Helm `values` file.",
-          "x-intellij-html-description": "<p>adds image configurations to the Helm <code>values</code> file.</p>\n"
+          "x-intellij-html-description": "adds image configurations to the Helm <code>values</code> file."
         },
         "name": {
           "type": "string",
           "description": "name of the Helm release.",
-          "x-intellij-html-description": "<p>name of the Helm release.</p>\n"
+          "x-intellij-html-description": "name of the Helm release."
         },
         "namespace": {
           "type": "string",
           "description": "Kubernetes namespace.",
-          "x-intellij-html-description": "<p>Kubernetes namespace.</p>\n"
+          "x-intellij-html-description": "Kubernetes namespace."
         },
         "overrides": {
           "additionalProperties": {},
           "type": "object",
           "description": "key-value pairs. If present, Skaffold will build a Helm `values` file that overrides the original and use it to call Helm CLI (`--f` flag).",
-          "x-intellij-html-description": "<p>key-value pairs. If present, Skaffold will build a Helm <code>values</code> file that overrides the original and use it to call Helm CLI (<code>--f</code> flag).</p>\n",
+          "x-intellij-html-description": "key-value pairs. If present, Skaffold will build a Helm <code>values</code> file that overrides the original and use it to call Helm CLI (<code>--f</code> flag).",
           "default": "{}"
         },
         "packaged": {
           "$ref": "#/definitions/HelmPackaged",
           "description": "parameters for packaging helm chart (`helm package`).",
-          "x-intellij-html-description": "<p>parameters for packaging helm chart (<code>helm package</code>).</p>\n"
+          "x-intellij-html-description": "parameters for packaging helm chart (<code>helm package</code>)."
         },
         "recreatePods": {
           "type": "boolean",
           "description": "if `true`, Skaffold will send `--recreate-pods` flag to Helm CLI.",
-          "x-intellij-html-description": "<p>if <code>true</code>, Skaffold will send <code>--recreate-pods</code> flag to Helm CLI.</p>\n",
+          "x-intellij-html-description": "if <code>true</code>, Skaffold will send <code>--recreate-pods</code> flag to Helm CLI.",
           "default": "false"
         },
         "setValueTemplates": {
@@ -973,7 +973,7 @@
           },
           "type": "object",
           "description": "key-value pairs. If present, Skaffold will try to parse the value part of each key-value pair using environment variables in the system, then send `--set` flag to Helm CLI and append all parsed pairs after the flag.",
-          "x-intellij-html-description": "<p>key-value pairs. If present, Skaffold will try to parse the value part of each key-value pair using environment variables in the system, then send <code>--set</code> flag to Helm CLI and append all parsed pairs after the flag.</p>\n",
+          "x-intellij-html-description": "key-value pairs. If present, Skaffold will try to parse the value part of each key-value pair using environment variables in the system, then send <code>--set</code> flag to Helm CLI and append all parsed pairs after the flag.",
           "default": "{}"
         },
         "setValues": {
@@ -982,13 +982,13 @@
           },
           "type": "object",
           "description": "key-value pairs. If present, Skaffold will send `--set` flag to Helm CLI and append all pairs after the flag.",
-          "x-intellij-html-description": "<p>key-value pairs. If present, Skaffold will send <code>--set</code> flag to Helm CLI and append all pairs after the flag.</p>\n",
+          "x-intellij-html-description": "key-value pairs. If present, Skaffold will send <code>--set</code> flag to Helm CLI and append all pairs after the flag.",
           "default": "{}"
         },
         "skipBuildDependencies": {
           "type": "boolean",
           "description": "should build dependencies be skipped.",
-          "x-intellij-html-description": "<p>should build dependencies be skipped.</p>\n",
+          "x-intellij-html-description": "should build dependencies be skipped.",
           "default": "false"
         },
         "values": {
@@ -997,7 +997,7 @@
           },
           "type": "object",
           "description": "key-value pairs supplementing the Helm `values` file\".",
-          "x-intellij-html-description": "<p>key-value pairs supplementing the Helm <code>values</code> file&quot;.</p>\n",
+          "x-intellij-html-description": "key-value pairs supplementing the Helm <code>values</code> file&quot;.",
           "default": "{}"
         },
         "valuesFiles": {
@@ -1006,18 +1006,18 @@
           },
           "type": "array",
           "description": "paths to the Helm `values` files\".",
-          "x-intellij-html-description": "<p>paths to the Helm <code>values</code> files&quot;.</p>\n",
+          "x-intellij-html-description": "paths to the Helm <code>values</code> files&quot;.",
           "default": "[]"
         },
         "version": {
           "type": "string",
           "description": "version of the chart.",
-          "x-intellij-html-description": "<p>version of the chart.</p>\n"
+          "x-intellij-html-description": "version of the chart."
         },
         "wait": {
           "type": "boolean",
           "description": "if `true`, Skaffold will send `--wait` flag to Helm CLI.",
-          "x-intellij-html-description": "<p>if <code>true</code>, Skaffold will send <code>--wait</code> flag to Helm CLI.</p>\n",
+          "x-intellij-html-description": "if <code>true</code>, Skaffold will send <code>--wait</code> flag to Helm CLI.",
           "default": "false"
         }
       },
@@ -1047,18 +1047,18 @@
         "from": {
           "type": "string",
           "description": "source position in the yaml, used for `copy` or `move` operations.",
-          "x-intellij-html-description": "<p>source position in the yaml, used for <code>copy</code> or <code>move</code> operations.</p>\n"
+          "x-intellij-html-description": "source position in the yaml, used for <code>copy</code> or <code>move</code> operations."
         },
         "op": {
           "type": "string",
           "description": "operation carried by the patch: `add`, `remove`, `replace`, `move`, `copy` or `test`.",
-          "x-intellij-html-description": "<p>operation carried by the patch: <code>add</code>, <code>remove</code>, <code>replace</code>, <code>move</code>, <code>copy</code> or <code>test</code>.</p>\n",
+          "x-intellij-html-description": "operation carried by the patch: <code>add</code>, <code>remove</code>, <code>replace</code>, <code>move</code>, <code>copy</code> or <code>test</code>.",
           "default": "replace"
         },
         "path": {
           "type": "string",
           "description": "position in the yaml where the operation takes place. For example, this targets the `dockerfile` of the first artifact built.",
-          "x-intellij-html-description": "<p>position in the yaml where the operation takes place. For example, this targets the <code>dockerfile</code> of the first artifact built.</p>\n",
+          "x-intellij-html-description": "position in the yaml where the operation takes place. For example, this targets the <code>dockerfile</code> of the first artifact built.",
           "examples": [
             "/build/artifacts/0/docker/dockerfile"
           ]
@@ -1066,7 +1066,7 @@
         "value": {
           "type": "object",
           "description": "value to apply. Can be any portion of yaml.",
-          "x-intellij-html-description": "<p>value to apply. Can be any portion of yaml.</p>\n"
+          "x-intellij-html-description": "value to apply. Can be any portion of yaml."
         }
       },
       "preferredOrder": [
@@ -1077,7 +1077,7 @@
       ],
       "additionalProperties": false,
       "description": "patch to be applied by a profile.",
-      "x-intellij-html-description": "<p>patch to be applied by a profile.</p>\n"
+      "x-intellij-html-description": "patch to be applied by a profile."
     },
     "JibGradleArtifact": {
       "properties": {
@@ -1087,7 +1087,7 @@
           },
           "type": "array",
           "description": "additional build flags passed to Gradle.",
-          "x-intellij-html-description": "<p>additional build flags passed to Gradle.</p>\n",
+          "x-intellij-html-description": "additional build flags passed to Gradle.",
           "default": "[]",
           "examples": [
             "[\"--no-build-cache\"]"
@@ -1096,7 +1096,7 @@
         "project": {
           "type": "string",
           "description": "selects which Gradle project to build.",
-          "x-intellij-html-description": "<p>selects which Gradle project to build.</p>\n"
+          "x-intellij-html-description": "selects which Gradle project to build."
         }
       },
       "preferredOrder": [
@@ -1105,7 +1105,7 @@
       ],
       "additionalProperties": false,
       "description": "*alpha* builds images using the [Jib plugin for Gradle](https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin).",
-      "x-intellij-html-description": "<p><em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin\">Jib plugin for Gradle</a>.</p>\n"
+      "x-intellij-html-description": "<em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin\">Jib plugin for Gradle</a>."
     },
     "JibMavenArtifact": {
       "properties": {
@@ -1115,7 +1115,7 @@
           },
           "type": "array",
           "description": "additional build flags passed to Maven.",
-          "x-intellij-html-description": "<p>additional build flags passed to Maven.</p>\n",
+          "x-intellij-html-description": "additional build flags passed to Maven.",
           "default": "[]",
           "examples": [
             "[\"-x\", \"-DskipTests\"]"
@@ -1124,12 +1124,12 @@
         "module": {
           "type": "string",
           "description": "selects which Maven module to build, for a multi module project.",
-          "x-intellij-html-description": "<p>selects which Maven module to build, for a multi module project.</p>\n"
+          "x-intellij-html-description": "selects which Maven module to build, for a multi module project."
         },
         "profile": {
           "type": "string",
           "description": "selects which Maven profile to activate.",
-          "x-intellij-html-description": "<p>selects which Maven profile to activate.</p>\n"
+          "x-intellij-html-description": "selects which Maven profile to activate."
         }
       },
       "preferredOrder": [
@@ -1139,24 +1139,24 @@
       ],
       "additionalProperties": false,
       "description": "*alpha* builds images using the [Jib plugin for Maven](https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin).",
-      "x-intellij-html-description": "<p><em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin\">Jib plugin for Maven</a>.</p>\n"
+      "x-intellij-html-description": "<em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin\">Jib plugin for Maven</a>."
     },
     "KanikoBuild": {
       "properties": {
         "buildContext": {
           "$ref": "#/definitions/KanikoBuildContext",
           "description": "defines where Kaniko gets the sources from.",
-          "x-intellij-html-description": "<p>defines where Kaniko gets the sources from.</p>\n"
+          "x-intellij-html-description": "defines where Kaniko gets the sources from."
         },
         "cache": {
           "$ref": "#/definitions/KanikoCache",
           "description": "configures Kaniko caching. If a cache is specified, Kaniko will use a remote cache which will speed up builds.",
-          "x-intellij-html-description": "<p>configures Kaniko caching. If a cache is specified, Kaniko will use a remote cache which will speed up builds.</p>\n"
+          "x-intellij-html-description": "configures Kaniko caching. If a cache is specified, Kaniko will use a remote cache which will speed up builds."
         },
         "dockerConfig": {
           "$ref": "#/definitions/DockerConfig",
           "description": "describes how to mount the local Docker configuration into the Kaniko pod.",
-          "x-intellij-html-description": "<p>describes how to mount the local Docker configuration into the Kaniko pod.</p>\n"
+          "x-intellij-html-description": "describes how to mount the local Docker configuration into the Kaniko pod."
         },
         "flags": {
           "items": {
@@ -1164,34 +1164,34 @@
           },
           "type": "array",
           "description": "additional flags to be passed to Kaniko command line. See [Kaniko Additional Flags](https://github.com/GoogleContainerTools/kaniko#additional-flags).",
-          "x-intellij-html-description": "<p>additional flags to be passed to Kaniko command line. See <a href=\"https://github.com/GoogleContainerTools/kaniko#additional-flags\">Kaniko Additional Flags</a>.</p>\n",
+          "x-intellij-html-description": "additional flags to be passed to Kaniko command line. See <a href=\"https://github.com/GoogleContainerTools/kaniko#additional-flags\">Kaniko Additional Flags</a>.",
           "default": "[]"
         },
         "image": {
           "type": "string",
           "description": "Docker image used by the Kaniko pod. Defaults to the latest released version of `gcr.io/kaniko-project/executor`.",
-          "x-intellij-html-description": "<p>Docker image used by the Kaniko pod. Defaults to the latest released version of <code>gcr.io/kaniko-project/executor</code>.</p>\n"
+          "x-intellij-html-description": "Docker image used by the Kaniko pod. Defaults to the latest released version of <code>gcr.io/kaniko-project/executor</code>."
         },
         "namespace": {
           "type": "string",
           "description": "Kubernetes namespace. Defaults to current namespace in Kubernetes configuration.",
-          "x-intellij-html-description": "<p>Kubernetes namespace. Defaults to current namespace in Kubernetes configuration.</p>\n"
+          "x-intellij-html-description": "Kubernetes namespace. Defaults to current namespace in Kubernetes configuration."
         },
         "pullSecret": {
           "type": "string",
           "description": "path to the secret key file. See [Kaniko Documentation](https://github.com/GoogleContainerTools/kaniko#running-kaniko-in-a-kubernetes-cluster).",
-          "x-intellij-html-description": "<p>path to the secret key file. See <a href=\"https://github.com/GoogleContainerTools/kaniko#running-kaniko-in-a-kubernetes-cluster\">Kaniko Documentation</a>.</p>\n"
+          "x-intellij-html-description": "path to the secret key file. See <a href=\"https://github.com/GoogleContainerTools/kaniko#running-kaniko-in-a-kubernetes-cluster\">Kaniko Documentation</a>."
         },
         "pullSecretName": {
           "type": "string",
           "description": "name of the Kubernetes secret for pulling the files from the build context and pushing the final image.",
-          "x-intellij-html-description": "<p>name of the Kubernetes secret for pulling the files from the build context and pushing the final image.</p>\n",
+          "x-intellij-html-description": "name of the Kubernetes secret for pulling the files from the build context and pushing the final image.",
           "default": "kaniko-secret"
         },
         "timeout": {
           "type": "string",
           "description": "amount of time (in seconds) that this build is allowed to run. Defaults to 20 minutes (`20m`).",
-          "x-intellij-html-description": "<p>amount of time (in seconds) that this build is allowed to run. Defaults to 20 minutes (<code>20m</code>).</p>\n"
+          "x-intellij-html-description": "amount of time (in seconds) that this build is allowed to run. Defaults to 20 minutes (<code>20m</code>)."
         }
       },
       "preferredOrder": [
@@ -1207,19 +1207,19 @@
       ],
       "additionalProperties": false,
       "description": "*beta* describes how to do an on-cluster build using [Kaniko](https://github.com/GoogleContainerTools/kaniko).",
-      "x-intellij-html-description": "<p><em>beta</em> describes how to do an on-cluster build using <a href=\"https://github.com/GoogleContainerTools/kaniko\">Kaniko</a>.</p>\n"
+      "x-intellij-html-description": "<em>beta</em> describes how to do an on-cluster build using <a href=\"https://github.com/GoogleContainerTools/kaniko\">Kaniko</a>."
     },
     "KanikoBuildContext": {
       "properties": {
         "gcsBucket": {
           "type": "string",
           "description": "CGS bucket to which sources are uploaded by Skaffold. Kaniko will need access to that bucket to download the sources.",
-          "x-intellij-html-description": "<p>CGS bucket to which sources are uploaded by Skaffold. Kaniko will need access to that bucket to download the sources.</p>\n"
+          "x-intellij-html-description": "CGS bucket to which sources are uploaded by Skaffold. Kaniko will need access to that bucket to download the sources."
         },
         "localDir": {
           "$ref": "#/definitions/LocalDir",
           "description": "configures how Kaniko mounts sources directly via an `emptyDir` volume.",
-          "x-intellij-html-description": "<p>configures how Kaniko mounts sources directly via an <code>emptyDir</code> volume.</p>\n"
+          "x-intellij-html-description": "configures how Kaniko mounts sources directly via an <code>emptyDir</code> volume."
         }
       },
       "preferredOrder": [
@@ -1228,14 +1228,14 @@
       ],
       "additionalProperties": false,
       "description": "contains the different fields available to specify a Kaniko build context.",
-      "x-intellij-html-description": "<p>contains the different fields available to specify a Kaniko build context.</p>\n"
+      "x-intellij-html-description": "contains the different fields available to specify a Kaniko build context."
     },
     "KanikoCache": {
       "properties": {
         "repo": {
           "type": "string",
           "description": "a remote repository to store cached layers. If none is specified, one will be inferred from the image name. See [Kaniko Caching](https://github.com/GoogleContainerTools/kaniko#caching).",
-          "x-intellij-html-description": "<p>a remote repository to store cached layers. If none is specified, one will be inferred from the image name. See <a href=\"https://github.com/GoogleContainerTools/kaniko#caching\">Kaniko Caching</a>.</p>\n"
+          "x-intellij-html-description": "a remote repository to store cached layers. If none is specified, one will be inferred from the image name. See <a href=\"https://github.com/GoogleContainerTools/kaniko#caching\">Kaniko Caching</a>."
         }
       },
       "preferredOrder": [
@@ -1243,14 +1243,14 @@
       ],
       "additionalProperties": false,
       "description": "configures Kaniko caching. If a cache is specified, Kaniko will use a remote cache which will speed up builds.",
-      "x-intellij-html-description": "<p>configures Kaniko caching. If a cache is specified, Kaniko will use a remote cache which will speed up builds.</p>\n"
+      "x-intellij-html-description": "configures Kaniko caching. If a cache is specified, Kaniko will use a remote cache which will speed up builds."
     },
     "KubectlDeploy": {
       "properties": {
         "flags": {
           "$ref": "#/definitions/KubectlFlags",
           "description": "additional flags passed to `kubectl`.",
-          "x-intellij-html-description": "<p>additional flags passed to <code>kubectl</code>.</p>\n"
+          "x-intellij-html-description": "additional flags passed to <code>kubectl</code>."
         },
         "manifests": {
           "items": {
@@ -1258,7 +1258,7 @@
           },
           "type": "array",
           "description": "the Kubernetes yaml or json manifests.",
-          "x-intellij-html-description": "<p>the Kubernetes yaml or json manifests.</p>\n",
+          "x-intellij-html-description": "the Kubernetes yaml or json manifests.",
           "default": "[\"k8s/*.yaml\"]"
         },
         "remoteManifests": {
@@ -1267,7 +1267,7 @@
           },
           "type": "array",
           "description": "Kubernetes manifests in remote clusters.",
-          "x-intellij-html-description": "<p>Kubernetes manifests in remote clusters.</p>\n",
+          "x-intellij-html-description": "Kubernetes manifests in remote clusters.",
           "default": "[]"
         }
       },
@@ -1278,7 +1278,7 @@
       ],
       "additionalProperties": false,
       "description": "*beta* uses a client side `kubectl apply` to deploy manifests. You'll need a `kubectl` CLI version installed that's compatible with your cluster.",
-      "x-intellij-html-description": "<p><em>beta</em> uses a client side <code>kubectl apply</code> to deploy manifests. You'll need a <code>kubectl</code> CLI version installed that's compatible with your cluster.</p>\n"
+      "x-intellij-html-description": "<em>beta</em> uses a client side <code>kubectl apply</code> to deploy manifests. You'll need a <code>kubectl</code> CLI version installed that's compatible with your cluster."
     },
     "KubectlFlags": {
       "properties": {
@@ -1288,7 +1288,7 @@
           },
           "type": "array",
           "description": "additional flags passed on creations (`kubectl apply`).",
-          "x-intellij-html-description": "<p>additional flags passed on creations (<code>kubectl apply</code>).</p>\n",
+          "x-intellij-html-description": "additional flags passed on creations (<code>kubectl apply</code>).",
           "default": "[]"
         },
         "delete": {
@@ -1297,7 +1297,7 @@
           },
           "type": "array",
           "description": "additional flags passed on deletions (`kubectl delete`).",
-          "x-intellij-html-description": "<p>additional flags passed on deletions (<code>kubectl delete</code>).</p>\n",
+          "x-intellij-html-description": "additional flags passed on deletions (<code>kubectl delete</code>).",
           "default": "[]"
         },
         "global": {
@@ -1306,7 +1306,7 @@
           },
           "type": "array",
           "description": "additional flags passed on every command.",
-          "x-intellij-html-description": "<p>additional flags passed on every command.</p>\n",
+          "x-intellij-html-description": "additional flags passed on every command.",
           "default": "[]"
         }
       },
@@ -1317,19 +1317,19 @@
       ],
       "additionalProperties": false,
       "description": "additional flags passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).",
-      "x-intellij-html-description": "<p>additional flags passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).</p>\n"
+      "x-intellij-html-description": "additional flags passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete)."
     },
     "KustomizeDeploy": {
       "properties": {
         "flags": {
           "$ref": "#/definitions/KubectlFlags",
           "description": "additional flags passed to `kubectl`.",
-          "x-intellij-html-description": "<p>additional flags passed to <code>kubectl</code>.</p>\n"
+          "x-intellij-html-description": "additional flags passed to <code>kubectl</code>."
         },
         "path": {
           "type": "string",
           "description": "path to Kustomization files.",
-          "x-intellij-html-description": "<p>path to Kustomization files.</p>\n",
+          "x-intellij-html-description": "path to Kustomization files.",
           "default": "."
         }
       },
@@ -1339,25 +1339,25 @@
       ],
       "additionalProperties": false,
       "description": "*beta* uses the `kustomize` CLI to \"patch\" a deployment for a target environment.",
-      "x-intellij-html-description": "<p><em>beta</em> uses the <code>kustomize</code> CLI to &quot;patch&quot; a deployment for a target environment.</p>\n"
+      "x-intellij-html-description": "<em>beta</em> uses the <code>kustomize</code> CLI to &quot;patch&quot; a deployment for a target environment."
     },
     "LocalBuild": {
       "properties": {
         "push": {
           "type": "boolean",
           "description": "should images be pushed to a registry. If not specified, images are pushed only if the current Kubernetes context connects to a remote cluster.",
-          "x-intellij-html-description": "<p>should images be pushed to a registry. If not specified, images are pushed only if the current Kubernetes context connects to a remote cluster.</p>\n"
+          "x-intellij-html-description": "should images be pushed to a registry. If not specified, images are pushed only if the current Kubernetes context connects to a remote cluster."
         },
         "useBuildkit": {
           "type": "boolean",
           "description": "use BuildKit to build Docker images.",
-          "x-intellij-html-description": "<p>use BuildKit to build Docker images.</p>\n",
+          "x-intellij-html-description": "use BuildKit to build Docker images.",
           "default": "false"
         },
         "useDockerCLI": {
           "type": "boolean",
           "description": "use `docker` command-line interface instead of Docker Engine APIs.",
-          "x-intellij-html-description": "<p>use <code>docker</code> command-line interface instead of Docker Engine APIs.</p>\n",
+          "x-intellij-html-description": "use <code>docker</code> command-line interface instead of Docker Engine APIs.",
           "default": "false"
         }
       },
@@ -1368,11 +1368,11 @@
       ],
       "additionalProperties": false,
       "description": "*beta* describes how to do a build on the local docker daemon and optionally push to a repository.",
-      "x-intellij-html-description": "<p><em>beta</em> describes how to do a build on the local docker daemon and optionally push to a repository.</p>\n"
+      "x-intellij-html-description": "<em>beta</em> describes how to do a build on the local docker daemon and optionally push to a repository."
     },
     "LocalDir": {
       "description": "configures how Kaniko mounts sources directly via an `emptyDir` volume.",
-      "x-intellij-html-description": "<p>configures how Kaniko mounts sources directly via an <code>emptyDir</code> volume.</p>\n"
+      "x-intellij-html-description": "configures how Kaniko mounts sources directly via an <code>emptyDir</code> volume."
     },
     "Profile": {
       "required": [
@@ -1385,22 +1385,22 @@
           },
           "type": "array",
           "description": "criteria by which a profile can be auto-activated.",
-          "x-intellij-html-description": "<p>criteria by which a profile can be auto-activated.</p>\n"
+          "x-intellij-html-description": "criteria by which a profile can be auto-activated."
         },
         "build": {
           "$ref": "#/definitions/BuildConfig",
           "description": "replaces the main `build` configuration.",
-          "x-intellij-html-description": "<p>replaces the main <code>build</code> configuration.</p>\n"
+          "x-intellij-html-description": "replaces the main <code>build</code> configuration."
         },
         "deploy": {
           "$ref": "#/definitions/DeployConfig",
           "description": "replaces the main `deploy` configuration.",
-          "x-intellij-html-description": "<p>replaces the main <code>deploy</code> configuration.</p>\n"
+          "x-intellij-html-description": "replaces the main <code>deploy</code> configuration."
         },
         "name": {
           "type": "string",
           "description": "a unique profile name.",
-          "x-intellij-html-description": "<p>a unique profile name.</p>\n",
+          "x-intellij-html-description": "a unique profile name.",
           "examples": [
             "profile-prod"
           ]
@@ -1411,7 +1411,7 @@
           },
           "type": "array",
           "description": "a list of patches applied to the configuration. Patches use the JSON patch notation.",
-          "x-intellij-html-description": "<p>a list of patches applied to the configuration. Patches use the JSON patch notation.</p>\n"
+          "x-intellij-html-description": "a list of patches applied to the configuration. Patches use the JSON patch notation."
         },
         "test": {
           "items": {
@@ -1419,7 +1419,7 @@
           },
           "type": "array",
           "description": "replaces the main `test` configuration.",
-          "x-intellij-html-description": "<p>replaces the main <code>test</code> configuration.</p>\n"
+          "x-intellij-html-description": "replaces the main <code>test</code> configuration."
         }
       },
       "preferredOrder": [
@@ -1432,33 +1432,33 @@
       ],
       "additionalProperties": false,
       "description": "*beta* profiles are used to override any `build`, `test` or `deploy` configuration.",
-      "x-intellij-html-description": "<p><em>beta</em> profiles are used to override any <code>build</code>, <code>test</code> or <code>deploy</code> configuration.</p>\n"
+      "x-intellij-html-description": "<em>beta</em> profiles are used to override any <code>build</code>, <code>test</code> or <code>deploy</code> configuration."
     },
     "ShaTagger": {
       "description": "*beta* tags images with their sha256 digest.",
-      "x-intellij-html-description": "<p><em>beta</em> tags images with their sha256 digest.</p>\n"
+      "x-intellij-html-description": "<em>beta</em> tags images with their sha256 digest."
     },
     "SkaffoldPipeline": {
       "properties": {
         "apiVersion": {
           "type": "string",
           "description": "version of the configuration.",
-          "x-intellij-html-description": "<p>version of the configuration.</p>\n"
+          "x-intellij-html-description": "version of the configuration."
         },
         "build": {
           "$ref": "#/definitions/BuildConfig",
           "description": "describes how images are built.",
-          "x-intellij-html-description": "<p>describes how images are built.</p>\n"
+          "x-intellij-html-description": "describes how images are built."
         },
         "deploy": {
           "$ref": "#/definitions/DeployConfig",
           "description": "describes how images are deployed.",
-          "x-intellij-html-description": "<p>describes how images are deployed.</p>\n"
+          "x-intellij-html-description": "describes how images are deployed."
         },
         "kind": {
           "type": "string",
           "description": "always `Config`.",
-          "x-intellij-html-description": "<p>always <code>Config</code>.</p>\n",
+          "x-intellij-html-description": "always <code>Config</code>.",
           "default": "Config"
         },
         "profiles": {
@@ -1467,7 +1467,7 @@
           },
           "type": "array",
           "description": "*beta* can override be used to `build`, `test` or `deploy` configuration.",
-          "x-intellij-html-description": "<p><em>beta</em> can override be used to <code>build</code>, <code>test</code> or <code>deploy</code> configuration.</p>\n"
+          "x-intellij-html-description": "<em>beta</em> can override be used to <code>build</code>, <code>test</code> or <code>deploy</code> configuration."
         },
         "test": {
           "items": {
@@ -1475,7 +1475,7 @@
           },
           "type": "array",
           "description": "describes how images are tested.",
-          "x-intellij-html-description": "<p>describes how images are tested.</p>\n"
+          "x-intellij-html-description": "describes how images are tested."
         }
       },
       "preferredOrder": [
@@ -1493,22 +1493,22 @@
         "dateTime": {
           "$ref": "#/definitions/DateTimeTagger",
           "description": "*beta* tags images with the build timestamp.",
-          "x-intellij-html-description": "<p><em>beta</em> tags images with the build timestamp.</p>\n"
+          "x-intellij-html-description": "<em>beta</em> tags images with the build timestamp."
         },
         "envTemplate": {
           "$ref": "#/definitions/EnvTemplateTagger",
           "description": "*beta* tags images with a configurable template string.",
-          "x-intellij-html-description": "<p><em>beta</em> tags images with a configurable template string.</p>\n"
+          "x-intellij-html-description": "<em>beta</em> tags images with a configurable template string."
         },
         "gitCommit": {
           "$ref": "#/definitions/GitTagger",
           "description": "*beta* tags images with the git tag or commit of the artifact's workspace.",
-          "x-intellij-html-description": "<p><em>beta</em> tags images with the git tag or commit of the artifact's workspace.</p>\n"
+          "x-intellij-html-description": "<em>beta</em> tags images with the git tag or commit of the artifact's workspace."
         },
         "sha256": {
           "$ref": "#/definitions/ShaTagger",
           "description": "*beta* tags images with their sha256 digest.",
-          "x-intellij-html-description": "<p><em>beta</em> tags images with their sha256 digest.</p>\n"
+          "x-intellij-html-description": "<em>beta</em> tags images with their sha256 digest."
         }
       },
       "preferredOrder": [
@@ -1519,7 +1519,7 @@
       ],
       "additionalProperties": false,
       "description": "contains all the configuration for the tagging step.",
-      "x-intellij-html-description": "<p>contains all the configuration for the tagging step.</p>\n"
+      "x-intellij-html-description": "contains all the configuration for the tagging step."
     },
     "TestCase": {
       "required": [
@@ -1529,7 +1529,7 @@
         "image": {
           "type": "string",
           "description": "artifact on which to run those tests.",
-          "x-intellij-html-description": "<p>artifact on which to run those tests.</p>\n",
+          "x-intellij-html-description": "artifact on which to run those tests.",
           "examples": [
             "gcr.io/k8s-skaffold/example"
           ]
@@ -1540,7 +1540,7 @@
           },
           "type": "array",
           "description": "the [Container Structure Tests](https://github.com/GoogleContainerTools/container-structure-test) to run on that artifact.",
-          "x-intellij-html-description": "<p>the <a href=\"https://github.com/GoogleContainerTools/container-structure-test\">Container Structure Tests</a> to run on that artifact.</p>\n",
+          "x-intellij-html-description": "the <a href=\"https://github.com/GoogleContainerTools/container-structure-test\">Container Structure Tests</a> to run on that artifact.",
           "default": "[]",
           "examples": [
             "[\"./test/*\"]"
@@ -1553,7 +1553,7 @@
       ],
       "additionalProperties": false,
       "description": "a list of structure tests to run on images that Skaffold builds.",
-      "x-intellij-html-description": "<p>a list of structure tests to run on images that Skaffold builds.</p>\n"
+      "x-intellij-html-description": "a list of structure tests to run on images that Skaffold builds."
     }
   }
 }
diff --git a/docs/content/en/schemas/v1beta6.json b/docs/content/en/schemas/v1beta6.json
index bc377529537..0d3a930e0f3 100755
--- a/docs/content/en/schemas/v1beta6.json
+++ b/docs/content/en/schemas/v1beta6.json
@@ -12,7 +12,7 @@
         "command": {
           "type": "string",
           "description": "a Skaffold command for which the profile is auto-activated.",
-          "x-intellij-html-description": "<p>a Skaffold command for which the profile is auto-activated.</p>\n",
+          "x-intellij-html-description": "a Skaffold command for which the profile is auto-activated.",
           "examples": [
             "dev"
           ]
@@ -20,7 +20,7 @@
         "env": {
           "type": "string",
           "description": "a `key=value` pair. The profile is auto-activated if an Environment Variable `key` has value `value`.",
-          "x-intellij-html-description": "<p>a <code>key=value</code> pair. The profile is auto-activated if an Environment Variable <code>key</code> has value <code>value</code>.</p>\n",
+          "x-intellij-html-description": "a <code>key=value</code> pair. The profile is auto-activated if an Environment Variable <code>key</code> has value <code>value</code>.",
           "examples": [
             "ENV=production"
           ]
@@ -28,7 +28,7 @@
         "kubeContext": {
           "type": "string",
           "description": "a Kubernetes context for which the profile is auto-activated.",
-          "x-intellij-html-description": "<p>a Kubernetes context for which the profile is auto-activated.</p>\n",
+          "x-intellij-html-description": "a Kubernetes context for which the profile is auto-activated.",
           "examples": [
             "minikube"
           ]
@@ -41,7 +41,7 @@
       ],
       "additionalProperties": false,
       "description": "criteria by which a profile is auto-activated.",
-      "x-intellij-html-description": "<p>criteria by which a profile is auto-activated.</p>\n"
+      "x-intellij-html-description": "criteria by which a profile is auto-activated."
     },
     "Artifact": {
       "required": [
@@ -53,13 +53,13 @@
             "context": {
               "type": "string",
               "description": "directory containing the artifact's sources.",
-              "x-intellij-html-description": "<p>directory containing the artifact's sources.</p>\n",
+              "x-intellij-html-description": "directory containing the artifact's sources.",
               "default": "."
             },
             "image": {
               "type": "string",
               "description": "name of the image to be built.",
-              "x-intellij-html-description": "<p>name of the image to be built.</p>\n",
+              "x-intellij-html-description": "name of the image to be built.",
               "examples": [
                 "gcr.io/k8s-skaffold/example"
               ]
@@ -67,7 +67,7 @@
             "plugin": {
               "$ref": "#/definitions/BuilderPlugin",
               "description": "plugin used to build this artifact.",
-              "x-intellij-html-description": "<p>plugin used to build this artifact.</p>\n"
+              "x-intellij-html-description": "plugin used to build this artifact."
             },
             "sync": {
               "additionalProperties": {
@@ -75,7 +75,7 @@
               },
               "type": "object",
               "description": "*alpha* local files synced to pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
-              "x-intellij-html-description": "<p><em>alpha</em> local files synced to pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.</p>\n",
+              "x-intellij-html-description": "<em>alpha</em> local files synced to pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
               "default": "{}",
               "examples": [
                 "{\"*.py\": \".\", \"css/**/*.css\": \"app/css\"}"
@@ -95,18 +95,18 @@
             "context": {
               "type": "string",
               "description": "directory containing the artifact's sources.",
-              "x-intellij-html-description": "<p>directory containing the artifact's sources.</p>\n",
+              "x-intellij-html-description": "directory containing the artifact's sources.",
               "default": "."
             },
             "docker": {
               "$ref": "#/definitions/DockerArtifact",
               "description": "*beta* describes an artifact built from a Dockerfile.",
-              "x-intellij-html-description": "<p><em>beta</em> describes an artifact built from a Dockerfile.</p>\n"
+              "x-intellij-html-description": "<em>beta</em> describes an artifact built from a Dockerfile."
             },
             "image": {
               "type": "string",
               "description": "name of the image to be built.",
-              "x-intellij-html-description": "<p>name of the image to be built.</p>\n",
+              "x-intellij-html-description": "name of the image to be built.",
               "examples": [
                 "gcr.io/k8s-skaffold/example"
               ]
@@ -114,7 +114,7 @@
             "plugin": {
               "$ref": "#/definitions/BuilderPlugin",
               "description": "plugin used to build this artifact.",
-              "x-intellij-html-description": "<p>plugin used to build this artifact.</p>\n"
+              "x-intellij-html-description": "plugin used to build this artifact."
             },
             "sync": {
               "additionalProperties": {
@@ -122,7 +122,7 @@
               },
               "type": "object",
               "description": "*alpha* local files synced to pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
-              "x-intellij-html-description": "<p><em>alpha</em> local files synced to pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.</p>\n",
+              "x-intellij-html-description": "<em>alpha</em> local files synced to pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
               "default": "{}",
               "examples": [
                 "{\"*.py\": \".\", \"css/**/*.css\": \"app/css\"}"
@@ -143,18 +143,18 @@
             "bazel": {
               "$ref": "#/definitions/BazelArtifact",
               "description": "*beta* requires bazel CLI to be installed and the sources to contain [Bazel](https://bazel.build/) configuration files.",
-              "x-intellij-html-description": "<p><em>beta</em> requires bazel CLI to be installed and the sources to contain <a href=\"https://bazel.build/\">Bazel</a> configuration files.</p>\n"
+              "x-intellij-html-description": "<em>beta</em> requires bazel CLI to be installed and the sources to contain <a href=\"https://bazel.build/\">Bazel</a> configuration files."
             },
             "context": {
               "type": "string",
               "description": "directory containing the artifact's sources.",
-              "x-intellij-html-description": "<p>directory containing the artifact's sources.</p>\n",
+              "x-intellij-html-description": "directory containing the artifact's sources.",
               "default": "."
             },
             "image": {
               "type": "string",
               "description": "name of the image to be built.",
-              "x-intellij-html-description": "<p>name of the image to be built.</p>\n",
+              "x-intellij-html-description": "name of the image to be built.",
               "examples": [
                 "gcr.io/k8s-skaffold/example"
               ]
@@ -162,7 +162,7 @@
             "plugin": {
               "$ref": "#/definitions/BuilderPlugin",
               "description": "plugin used to build this artifact.",
-              "x-intellij-html-description": "<p>plugin used to build this artifact.</p>\n"
+              "x-intellij-html-description": "plugin used to build this artifact."
             },
             "sync": {
               "additionalProperties": {
@@ -170,7 +170,7 @@
               },
               "type": "object",
               "description": "*alpha* local files synced to pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
-              "x-intellij-html-description": "<p><em>alpha</em> local files synced to pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.</p>\n",
+              "x-intellij-html-description": "<em>alpha</em> local files synced to pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
               "default": "{}",
               "examples": [
                 "{\"*.py\": \".\", \"css/**/*.css\": \"app/css\"}"
@@ -191,13 +191,13 @@
             "context": {
               "type": "string",
               "description": "directory containing the artifact's sources.",
-              "x-intellij-html-description": "<p>directory containing the artifact's sources.</p>\n",
+              "x-intellij-html-description": "directory containing the artifact's sources.",
               "default": "."
             },
             "image": {
               "type": "string",
               "description": "name of the image to be built.",
-              "x-intellij-html-description": "<p>name of the image to be built.</p>\n",
+              "x-intellij-html-description": "name of the image to be built.",
               "examples": [
                 "gcr.io/k8s-skaffold/example"
               ]
@@ -205,12 +205,12 @@
             "jibMaven": {
               "$ref": "#/definitions/JibMavenArtifact",
               "description": "*alpha* builds images using the [Jib plugin for Maven](https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin).",
-              "x-intellij-html-description": "<p><em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin\">Jib plugin for Maven</a>.</p>\n"
+              "x-intellij-html-description": "<em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin\">Jib plugin for Maven</a>."
             },
             "plugin": {
               "$ref": "#/definitions/BuilderPlugin",
               "description": "plugin used to build this artifact.",
-              "x-intellij-html-description": "<p>plugin used to build this artifact.</p>\n"
+              "x-intellij-html-description": "plugin used to build this artifact."
             },
             "sync": {
               "additionalProperties": {
@@ -218,7 +218,7 @@
               },
               "type": "object",
               "description": "*alpha* local files synced to pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
-              "x-intellij-html-description": "<p><em>alpha</em> local files synced to pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.</p>\n",
+              "x-intellij-html-description": "<em>alpha</em> local files synced to pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
               "default": "{}",
               "examples": [
                 "{\"*.py\": \".\", \"css/**/*.css\": \"app/css\"}"
@@ -239,13 +239,13 @@
             "context": {
               "type": "string",
               "description": "directory containing the artifact's sources.",
-              "x-intellij-html-description": "<p>directory containing the artifact's sources.</p>\n",
+              "x-intellij-html-description": "directory containing the artifact's sources.",
               "default": "."
             },
             "image": {
               "type": "string",
               "description": "name of the image to be built.",
-              "x-intellij-html-description": "<p>name of the image to be built.</p>\n",
+              "x-intellij-html-description": "name of the image to be built.",
               "examples": [
                 "gcr.io/k8s-skaffold/example"
               ]
@@ -253,12 +253,12 @@
             "jibGradle": {
               "$ref": "#/definitions/JibGradleArtifact",
               "description": "*alpha* builds images using the [Jib plugin for Gradle](https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin).",
-              "x-intellij-html-description": "<p><em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin\">Jib plugin for Gradle</a>.</p>\n"
+              "x-intellij-html-description": "<em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin\">Jib plugin for Gradle</a>."
             },
             "plugin": {
               "$ref": "#/definitions/BuilderPlugin",
               "description": "plugin used to build this artifact.",
-              "x-intellij-html-description": "<p>plugin used to build this artifact.</p>\n"
+              "x-intellij-html-description": "plugin used to build this artifact."
             },
             "sync": {
               "additionalProperties": {
@@ -266,7 +266,7 @@
               },
               "type": "object",
               "description": "*alpha* local files synced to pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
-              "x-intellij-html-description": "<p><em>alpha</em> local files synced to pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.</p>\n",
+              "x-intellij-html-description": "<em>alpha</em> local files synced to pods instead of triggering an image build when modified. This is a mapping of local files to sync to remote folders.",
               "default": "{}",
               "examples": [
                 "{\"*.py\": \".\", \"css/**/*.css\": \"app/css\"}"
@@ -284,29 +284,29 @@
         }
       ],
       "description": "items that need to be built, along with the context in which they should be built.",
-      "x-intellij-html-description": "<p>items that need to be built, along with the context in which they should be built.</p>\n"
+      "x-intellij-html-description": "items that need to be built, along with the context in which they should be built."
     },
     "ArtifactType": {
       "properties": {
         "bazel": {
           "$ref": "#/definitions/BazelArtifact",
           "description": "*beta* requires bazel CLI to be installed and the sources to contain [Bazel](https://bazel.build/) configuration files.",
-          "x-intellij-html-description": "<p><em>beta</em> requires bazel CLI to be installed and the sources to contain <a href=\"https://bazel.build/\">Bazel</a> configuration files.</p>\n"
+          "x-intellij-html-description": "<em>beta</em> requires bazel CLI to be installed and the sources to contain <a href=\"https://bazel.build/\">Bazel</a> configuration files."
         },
         "docker": {
           "$ref": "#/definitions/DockerArtifact",
           "description": "*beta* describes an artifact built from a Dockerfile.",
-          "x-intellij-html-description": "<p><em>beta</em> describes an artifact built from a Dockerfile.</p>\n"
+          "x-intellij-html-description": "<em>beta</em> describes an artifact built from a Dockerfile."
         },
         "jibGradle": {
           "$ref": "#/definitions/JibGradleArtifact",
           "description": "*alpha* builds images using the [Jib plugin for Gradle](https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin).",
-          "x-intellij-html-description": "<p><em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin\">Jib plugin for Gradle</a>.</p>\n"
+          "x-intellij-html-description": "<em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin\">Jib plugin for Gradle</a>."
         },
         "jibMaven": {
           "$ref": "#/definitions/JibMavenArtifact",
           "description": "*alpha* builds images using the [Jib plugin for Maven](https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin).",
-          "x-intellij-html-description": "<p><em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin\">Jib plugin for Maven</a>.</p>\n"
+          "x-intellij-html-description": "<em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin\">Jib plugin for Maven</a>."
         }
       },
       "preferredOrder": [
@@ -317,7 +317,7 @@
       ],
       "additionalProperties": false,
       "description": "describes how to build an artifact.",
-      "x-intellij-html-description": "<p>describes how to build an artifact.</p>\n"
+      "x-intellij-html-description": "describes how to build an artifact."
     },
     "BazelArtifact": {
       "required": [
@@ -330,7 +330,7 @@
           },
           "type": "array",
           "description": "additional args to pass to `bazel build`.",
-          "x-intellij-html-description": "<p>additional args to pass to <code>bazel build</code>.</p>\n",
+          "x-intellij-html-description": "additional args to pass to <code>bazel build</code>.",
           "default": "[]",
           "examples": [
             "[\"-flag\", \"--otherflag\"]"
@@ -339,7 +339,7 @@
         "target": {
           "type": "string",
           "description": "`bazel build` target to run.",
-          "x-intellij-html-description": "<p><code>bazel build</code> target to run.</p>\n",
+          "x-intellij-html-description": "<code>bazel build</code> target to run.",
           "examples": [
             "//:skaffold_example.tar"
           ]
@@ -351,7 +351,7 @@
       ],
       "additionalProperties": false,
       "description": "*beta* describes an artifact built with [Bazel](https://bazel.build/).",
-      "x-intellij-html-description": "<p><em>beta</em> describes an artifact built with <a href=\"https://bazel.build/\">Bazel</a>.</p>\n"
+      "x-intellij-html-description": "<em>beta</em> describes an artifact built with <a href=\"https://bazel.build/\">Bazel</a>."
     },
     "BuildConfig": {
       "anyOf": [
@@ -363,17 +363,17 @@
               },
               "type": "array",
               "description": "the images you're going to be building.",
-              "x-intellij-html-description": "<p>the images you're going to be building.</p>\n"
+              "x-intellij-html-description": "the images you're going to be building."
             },
             "executionEnvironment": {
               "$ref": "#/definitions/ExecutionEnvironment",
               "description": "environment in which the build should run. Possible values: googleCloudBuild.",
-              "x-intellij-html-description": "<p>environment in which the build should run. Possible values: googleCloudBuild.</p>\n"
+              "x-intellij-html-description": "environment in which the build should run. Possible values: googleCloudBuild."
             },
             "tagPolicy": {
               "$ref": "#/definitions/TagPolicy",
               "description": "*beta* determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to `gitCommit: {}`.",
-              "x-intellij-html-description": "<p><em>beta</em> determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>.</p>\n"
+              "x-intellij-html-description": "<em>beta</em> determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>."
             }
           },
           "preferredOrder": [
@@ -391,22 +391,22 @@
               },
               "type": "array",
               "description": "the images you're going to be building.",
-              "x-intellij-html-description": "<p>the images you're going to be building.</p>\n"
+              "x-intellij-html-description": "the images you're going to be building."
             },
             "executionEnvironment": {
               "$ref": "#/definitions/ExecutionEnvironment",
               "description": "environment in which the build should run. Possible values: googleCloudBuild.",
-              "x-intellij-html-description": "<p>environment in which the build should run. Possible values: googleCloudBuild.</p>\n"
+              "x-intellij-html-description": "environment in which the build should run. Possible values: googleCloudBuild."
             },
             "local": {
               "$ref": "#/definitions/LocalBuild",
               "description": "*beta* describes how to do a build on the local docker daemon and optionally push to a repository.",
-              "x-intellij-html-description": "<p><em>beta</em> describes how to do a build on the local docker daemon and optionally push to a repository.</p>\n"
+              "x-intellij-html-description": "<em>beta</em> describes how to do a build on the local docker daemon and optionally push to a repository."
             },
             "tagPolicy": {
               "$ref": "#/definitions/TagPolicy",
               "description": "*beta* determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to `gitCommit: {}`.",
-              "x-intellij-html-description": "<p><em>beta</em> determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>.</p>\n"
+              "x-intellij-html-description": "<em>beta</em> determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>."
             }
           },
           "preferredOrder": [
@@ -425,22 +425,22 @@
               },
               "type": "array",
               "description": "the images you're going to be building.",
-              "x-intellij-html-description": "<p>the images you're going to be building.</p>\n"
+              "x-intellij-html-description": "the images you're going to be building."
             },
             "executionEnvironment": {
               "$ref": "#/definitions/ExecutionEnvironment",
               "description": "environment in which the build should run. Possible values: googleCloudBuild.",
-              "x-intellij-html-description": "<p>environment in which the build should run. Possible values: googleCloudBuild.</p>\n"
+              "x-intellij-html-description": "environment in which the build should run. Possible values: googleCloudBuild."
             },
             "googleCloudBuild": {
               "$ref": "#/definitions/GoogleCloudBuild",
               "description": "*beta* describes how to do a remote build on [Google Cloud Build](https://cloud.google.com/cloud-build/).",
-              "x-intellij-html-description": "<p><em>beta</em> describes how to do a remote build on <a href=\"https://cloud.google.com/cloud-build/\">Google Cloud Build</a>.</p>\n"
+              "x-intellij-html-description": "<em>beta</em> describes how to do a remote build on <a href=\"https://cloud.google.com/cloud-build/\">Google Cloud Build</a>."
             },
             "tagPolicy": {
               "$ref": "#/definitions/TagPolicy",
               "description": "*beta* determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to `gitCommit: {}`.",
-              "x-intellij-html-description": "<p><em>beta</em> determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>.</p>\n"
+              "x-intellij-html-description": "<em>beta</em> determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>."
             }
           },
           "preferredOrder": [
@@ -459,22 +459,22 @@
               },
               "type": "array",
               "description": "the images you're going to be building.",
-              "x-intellij-html-description": "<p>the images you're going to be building.</p>\n"
+              "x-intellij-html-description": "the images you're going to be building."
             },
             "executionEnvironment": {
               "$ref": "#/definitions/ExecutionEnvironment",
               "description": "environment in which the build should run. Possible values: googleCloudBuild.",
-              "x-intellij-html-description": "<p>environment in which the build should run. Possible values: googleCloudBuild.</p>\n"
+              "x-intellij-html-description": "environment in which the build should run. Possible values: googleCloudBuild."
             },
             "kaniko": {
               "$ref": "#/definitions/KanikoBuild",
               "description": "*beta* describes how to do an on-cluster build using [Kaniko](https://github.com/GoogleContainerTools/kaniko).",
-              "x-intellij-html-description": "<p><em>beta</em> describes how to do an on-cluster build using <a href=\"https://github.com/GoogleContainerTools/kaniko\">Kaniko</a>.</p>\n"
+              "x-intellij-html-description": "<em>beta</em> describes how to do an on-cluster build using <a href=\"https://github.com/GoogleContainerTools/kaniko\">Kaniko</a>."
             },
             "tagPolicy": {
               "$ref": "#/definitions/TagPolicy",
               "description": "*beta* determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to `gitCommit: {}`.",
-              "x-intellij-html-description": "<p><em>beta</em> determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>.</p>\n"
+              "x-intellij-html-description": "<em>beta</em> determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {}</code>."
             }
           },
           "preferredOrder": [
@@ -487,24 +487,24 @@
         }
       ],
       "description": "contains all the configuration for the build steps.",
-      "x-intellij-html-description": "<p>contains all the configuration for the build steps.</p>\n"
+      "x-intellij-html-description": "contains all the configuration for the build steps."
     },
     "BuildType": {
       "properties": {
         "googleCloudBuild": {
           "$ref": "#/definitions/GoogleCloudBuild",
           "description": "*beta* describes how to do a remote build on [Google Cloud Build](https://cloud.google.com/cloud-build/).",
-          "x-intellij-html-description": "<p><em>beta</em> describes how to do a remote build on <a href=\"https://cloud.google.com/cloud-build/\">Google Cloud Build</a>.</p>\n"
+          "x-intellij-html-description": "<em>beta</em> describes how to do a remote build on <a href=\"https://cloud.google.com/cloud-build/\">Google Cloud Build</a>."
         },
         "kaniko": {
           "$ref": "#/definitions/KanikoBuild",
           "description": "*beta* describes how to do an on-cluster build using [Kaniko](https://github.com/GoogleContainerTools/kaniko).",
-          "x-intellij-html-description": "<p><em>beta</em> describes how to do an on-cluster build using <a href=\"https://github.com/GoogleContainerTools/kaniko\">Kaniko</a>.</p>\n"
+          "x-intellij-html-description": "<em>beta</em> describes how to do an on-cluster build using <a href=\"https://github.com/GoogleContainerTools/kaniko\">Kaniko</a>."
         },
         "local": {
           "$ref": "#/definitions/LocalBuild",
           "description": "*beta* describes how to do a build on the local docker daemon and optionally push to a repository.",
-          "x-intellij-html-description": "<p><em>beta</em> describes how to do a build on the local docker daemon and optionally push to a repository.</p>\n"
+          "x-intellij-html-description": "<em>beta</em> describes how to do a build on the local docker daemon and optionally push to a repository."
         }
       },
       "preferredOrder": [
@@ -514,20 +514,20 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated.",
-      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the build step. Only one field should be populated.</p>\n"
+      "x-intellij-html-description": "contains the specific implementation and parameters needed for the build step. Only one field should be populated."
     },
     "BuilderPlugin": {
       "properties": {
         "name": {
           "type": "string",
           "description": "name of the build plugin.",
-          "x-intellij-html-description": "<p>name of the build plugin.</p>\n"
+          "x-intellij-html-description": "name of the build plugin."
         },
         "properties": {
           "additionalProperties": {},
           "type": "object",
           "description": "key-value pairs passed to the plugin.",
-          "x-intellij-html-description": "<p>key-value pairs passed to the plugin.</p>\n",
+          "x-intellij-html-description": "key-value pairs passed to the plugin.",
           "default": "{}"
         }
       },
@@ -537,20 +537,20 @@
       ],
       "additionalProperties": false,
       "description": "contains all fields necessary for specifying a build plugin.",
-      "x-intellij-html-description": "<p>contains all fields necessary for specifying a build plugin.</p>\n"
+      "x-intellij-html-description": "contains all fields necessary for specifying a build plugin."
     },
     "DateTimeTagger": {
       "properties": {
         "format": {
           "type": "string",
           "description": "formats the date and time. See [#Time.Format](https://golang.org/pkg/time/#Time.Format).",
-          "x-intellij-html-description": "<p>formats the date and time. See <a href=\"https://golang.org/pkg/time/#Time.Format\">#Time.Format</a>.</p>\n",
+          "x-intellij-html-description": "formats the date and time. See <a href=\"https://golang.org/pkg/time/#Time.Format\">#Time.Format</a>.",
           "default": "2006-01-02_15-04-05.999_MST"
         },
         "timezone": {
           "type": "string",
           "description": "sets the timezone for the date and time. See [Time.LoadLocation](https://golang.org/pkg/time/#Time.LoadLocation). Defaults to the local timezone.",
-          "x-intellij-html-description": "<p>sets the timezone for the date and time. See <a href=\"https://golang.org/pkg/time/#Time.LoadLocation\">Time.LoadLocation</a>. Defaults to the local timezone.</p>\n"
+          "x-intellij-html-description": "sets the timezone for the date and time. See <a href=\"https://golang.org/pkg/time/#Time.LoadLocation\">Time.LoadLocation</a>. Defaults to the local timezone."
         }
       },
       "preferredOrder": [
@@ -559,7 +559,7 @@
       ],
       "additionalProperties": false,
       "description": "*beta* tags images with the build timestamp.",
-      "x-intellij-html-description": "<p><em>beta</em> tags images with the build timestamp.</p>\n"
+      "x-intellij-html-description": "<em>beta</em> tags images with the build timestamp."
     },
     "DeployConfig": {
       "anyOf": [
@@ -571,7 +571,7 @@
             "helm": {
               "$ref": "#/definitions/HelmDeploy",
               "description": "*beta* uses the `helm` CLI to apply the charts to the cluster.",
-              "x-intellij-html-description": "<p><em>beta</em> uses the <code>helm</code> CLI to apply the charts to the cluster.</p>\n"
+              "x-intellij-html-description": "<em>beta</em> uses the <code>helm</code> CLI to apply the charts to the cluster."
             }
           },
           "preferredOrder": [
@@ -584,7 +584,7 @@
             "kubectl": {
               "$ref": "#/definitions/KubectlDeploy",
               "description": "*beta* uses a client side `kubectl apply` to deploy manifests. You'll need a `kubectl` CLI version installed that's compatible with your cluster.",
-              "x-intellij-html-description": "<p><em>beta</em> uses a client side <code>kubectl apply</code> to deploy manifests. You'll need a <code>kubectl</code> CLI version installed that's compatible with your cluster.</p>\n"
+              "x-intellij-html-description": "<em>beta</em> uses a client side <code>kubectl apply</code> to deploy manifests. You'll need a <code>kubectl</code> CLI version installed that's compatible with your cluster."
             }
           },
           "preferredOrder": [
@@ -597,7 +597,7 @@
             "kustomize": {
               "$ref": "#/definitions/KustomizeDeploy",
               "description": "*beta* uses the `kustomize` CLI to \"patch\" a deployment for a target environment.",
-              "x-intellij-html-description": "<p><em>beta</em> uses the <code>kustomize</code> CLI to &quot;patch&quot; a deployment for a target environment.</p>\n"
+              "x-intellij-html-description": "<em>beta</em> uses the <code>kustomize</code> CLI to &quot;patch&quot; a deployment for a target environment."
             }
           },
           "preferredOrder": [
@@ -607,24 +607,24 @@
         }
       ],
       "description": "contains all the configuration needed by the deploy steps.",
-      "x-intellij-html-description": "<p>contains all the configuration needed by the deploy steps.</p>\n"
+      "x-intellij-html-description": "contains all the configuration needed by the deploy steps."
     },
     "DeployType": {
       "properties": {
         "helm": {
           "$ref": "#/definitions/HelmDeploy",
           "description": "*beta* uses the `helm` CLI to apply the charts to the cluster.",
-          "x-intellij-html-description": "<p><em>beta</em> uses the <code>helm</code> CLI to apply the charts to the cluster.</p>\n"
+          "x-intellij-html-description": "<em>beta</em> uses the <code>helm</code> CLI to apply the charts to the cluster."
         },
         "kubectl": {
           "$ref": "#/definitions/KubectlDeploy",
           "description": "*beta* uses a client side `kubectl apply` to deploy manifests. You'll need a `kubectl` CLI version installed that's compatible with your cluster.",
-          "x-intellij-html-description": "<p><em>beta</em> uses a client side <code>kubectl apply</code> to deploy manifests. You'll need a <code>kubectl</code> CLI version installed that's compatible with your cluster.</p>\n"
+          "x-intellij-html-description": "<em>beta</em> uses a client side <code>kubectl apply</code> to deploy manifests. You'll need a <code>kubectl</code> CLI version installed that's compatible with your cluster."
         },
         "kustomize": {
           "$ref": "#/definitions/KustomizeDeploy",
           "description": "*beta* uses the `kustomize` CLI to \"patch\" a deployment for a target environment.",
-          "x-intellij-html-description": "<p><em>beta</em> uses the <code>kustomize</code> CLI to &quot;patch&quot; a deployment for a target environment.</p>\n"
+          "x-intellij-html-description": "<em>beta</em> uses the <code>kustomize</code> CLI to &quot;patch&quot; a deployment for a target environment."
         }
       },
       "preferredOrder": [
@@ -634,7 +634,7 @@
       ],
       "additionalProperties": false,
       "description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.",
-      "x-intellij-html-description": "<p>contains the specific implementation and parameters needed for the deploy step. Only one field should be populated.</p>\n"
+      "x-intellij-html-description": "contains the specific implementation and parameters needed for the deploy step. Only one field should be populated."
     },
     "DockerArtifact": {
       "properties": {
@@ -644,7 +644,7 @@
           },
           "type": "object",
           "description": "arguments passed to the docker build.",
-          "x-intellij-html-description": "<p>arguments passed to the docker build.</p>\n",
+          "x-intellij-html-description": "arguments passed to the docker build.",
           "default": "{}",
           "examples": [
             "{\"key1\": \"value1\", \"key2\": \"value2\"}"
@@ -656,7 +656,7 @@
           },
           "type": "array",
           "description": "the Docker images used as cache sources.",
-          "x-intellij-html-description": "<p>the Docker images used as cache sources.</p>\n",
+          "x-intellij-html-description": "the Docker images used as cache sources.",
           "default": "[]",
           "examples": [
             "[\"golang:1.10.1-alpine3.7\", \"alpine:3.7\"]"
@@ -665,13 +665,13 @@
         "dockerfile": {
           "type": "string",
           "description": "locates the Dockerfile relative to workspace.",
-          "x-intellij-html-description": "<p>locates the Dockerfile relative to workspace.</p>\n",
+          "x-intellij-html-description": "locates the Dockerfile relative to workspace.",
           "default": "Dockerfile"
         },
         "target": {
           "type": "string",
           "description": "Dockerfile target name to build.",
-          "x-intellij-html-description": "<p>Dockerfile target name to build.</p>\n"
+          "x-intellij-html-description": "Dockerfile target name to build."
         }
       },
       "preferredOrder": [
@@ -682,19 +682,19 @@
       ],
       "additionalProperties": false,
       "description": "*beta* describes an artifact built from a Dockerfile, usually using `docker build`.",
-      "x-intellij-html-description": "<p><em>beta</em> describes an artifact built from a Dockerfile, usually using <code>docker build</code>.</p>\n"
+      "x-intellij-html-description": "<em>beta</em> describes an artifact built from a Dockerfile, usually using <code>docker build</code>."
     },
     "DockerConfig": {
       "properties": {
         "path": {
           "type": "string",
           "description": "path to the docker `config.json`.",
-          "x-intellij-html-description": "<p>path to the docker <code>config.json</code>.</p>\n"
+          "x-intellij-html-description": "path to the docker <code>config.json</code>."
         },
         "secretName": {
           "type": "string",
           "description": "Kubernetes secret that will hold the Docker configuration.",
-          "x-intellij-html-description": "<p>Kubernetes secret that will hold the Docker configuration.</p>\n"
+          "x-intellij-html-description": "Kubernetes secret that will hold the Docker configuration."
         }
       },
       "preferredOrder": [
@@ -703,7 +703,7 @@
       ],
       "additionalProperties": false,
       "description": "contains information about the docker `config.json` to mount.",
-      "x-intellij-html-description": "<p>contains information about the docker <code>config.json</code> to mount.</p>\n"
+      "x-intellij-html-description": "contains information about the docker <code>config.json</code> to mount."
     },
     "EnvTemplateTagger": {
       "required": [
@@ -713,7 +713,7 @@
         "template": {
           "type": "string",
           "description": "used to produce the image name and tag. See golang [text/template](https://golang.org/pkg/text/template/). The template is executed against the current environment, with those variables injected:   IMAGE_NAME   |  Name of the image being built, as supplied in the artifacts section.",
-          "x-intellij-html-description": "<p>used to produce the image name and tag. See golang <a href=\"https://golang.org/pkg/text/template/\">text/template</a>. The template is executed against the current environment, with those variables injected:   IMAGE_NAME   |  Name of the image being built, as supplied in the artifacts section.</p>\n",
+          "x-intellij-html-description": "used to produce the image name and tag. See golang <a href=\"https://golang.org/pkg/text/template/\">text/template</a>. The template is executed against the current environment, with those variables injected:   IMAGE_NAME   |  Name of the image being built, as supplied in the artifacts section.",
           "examples": [
             "{{.RELEASE}}-{{.IMAGE_NAME}}"
           ]
@@ -724,25 +724,25 @@
       ],
       "additionalProperties": false,
       "description": "*beta* tags images with a configurable template string.",
-      "x-intellij-html-description": "<p><em>beta</em> tags images with a configurable template string.</p>\n"
+      "x-intellij-html-description": "<em>beta</em> tags images with a configurable template string."
     },
     "ExecEnvironment": {
       "type": "string",
       "description": "name of an execution environment.",
-      "x-intellij-html-description": "<p>name of an execution environment.</p>\n"
+      "x-intellij-html-description": "name of an execution environment."
     },
     "ExecutionEnvironment": {
       "properties": {
         "name": {
           "$ref": "#/definitions/ExecEnvironment",
           "description": "name of the environment.",
-          "x-intellij-html-description": "<p>name of the environment.</p>\n"
+          "x-intellij-html-description": "name of the environment."
         },
         "properties": {
           "additionalProperties": {},
           "type": "object",
           "description": "key-value pairs passed to the environment.",
-          "x-intellij-html-description": "<p>key-value pairs passed to the environment.</p>\n",
+          "x-intellij-html-description": "key-value pairs passed to the environment.",
           "default": "{}"
         }
       },
@@ -752,51 +752,51 @@
       ],
       "additionalProperties": false,
       "description": "environment in which the build should run (ex. local or in-cluster, etc.).",
-      "x-intellij-html-description": "<p>environment in which the build should run (ex. local or in-cluster, etc.).</p>\n"
+      "x-intellij-html-description": "environment in which the build should run (ex. local or in-cluster, etc.)."
     },
     "GitTagger": {
       "description": "*beta* tags images with the git tag or commit of the artifact's workspace.",
-      "x-intellij-html-description": "<p><em>beta</em> tags images with the git tag or commit of the artifact's workspace.</p>\n"
+      "x-intellij-html-description": "<em>beta</em> tags images with the git tag or commit of the artifact's workspace."
     },
     "GoogleCloudBuild": {
       "properties": {
         "diskSizeGb": {
           "type": "number",
           "description": "disk size of the VM that runs the build. See [Cloud Build Reference](https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#buildoptions).",
-          "x-intellij-html-description": "<p>disk size of the VM that runs the build. See <a href=\"https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#buildoptions\">Cloud Build Reference</a>.</p>\n"
+          "x-intellij-html-description": "disk size of the VM that runs the build. See <a href=\"https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#buildoptions\">Cloud Build Reference</a>."
         },
         "dockerImage": {
           "type": "string",
           "description": "image that runs a Docker build. See [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders).",
-          "x-intellij-html-description": "<p>image that runs a Docker build. See <a href=\"https://cloud.google.com/cloud-build/docs/cloud-builders\">Cloud Builders</a>.</p>\n",
+          "x-intellij-html-description": "image that runs a Docker build. See <a href=\"https://cloud.google.com/cloud-build/docs/cloud-builders\">Cloud Builders</a>.",
           "default": "gcr.io/cloud-builders/docker"
         },
         "gradleImage": {
           "type": "string",
           "description": "image that runs a Gradle build. See [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders).",
-          "x-intellij-html-description": "<p>image that runs a Gradle build. See <a href=\"https://cloud.google.com/cloud-build/docs/cloud-builders\">Cloud Builders</a>.</p>\n",
+          "x-intellij-html-description": "image that runs a Gradle build. See <a href=\"https://cloud.google.com/cloud-build/docs/cloud-builders\">Cloud Builders</a>.",
           "default": "gcr.io/cloud-builders/gradle"
         },
         "machineType": {
           "type": "string",
           "description": "type of the VM that runs the build. See [Cloud Build Reference](https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#buildoptions).",
-          "x-intellij-html-description": "<p>type of the VM that runs the build. See <a href=\"https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#buildoptions\">Cloud Build Reference</a>.</p>\n"
+          "x-intellij-html-description": "type of the VM that runs the build. See <a href=\"https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#buildoptions\">Cloud Build Reference</a>."
         },
         "mavenImage": {
           "type": "string",
           "description": "image that runs a Maven build. See [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders).",
-          "x-intellij-html-description": "<p>image that runs a Maven build. See <a href=\"https://cloud.google.com/cloud-build/docs/cloud-builders\">Cloud Builders</a>.</p>\n",
+          "x-intellij-html-description": "image that runs a Maven build. See <a href=\"https://cloud.google.com/cloud-build/docs/cloud-builders\">Cloud Builders</a>.",
           "default": "gcr.io/cloud-builders/mvn"
         },
         "projectId": {
           "type": "string",
           "description": "ID of your Cloud Platform Project. If it is not provided, Skaffold will guess it from the image name. For example, given the artifact image name `gcr.io/myproject/image`, Skaffold will use the `myproject` GCP project.",
-          "x-intellij-html-description": "<p>ID of your Cloud Platform Project. If it is not provided, Skaffold will guess it from the image name. For example, given the artifact image name <code>gcr.io/myproject/image</code>, Skaffold will use the <code>myproject</code> GCP project.</p>\n"
+          "x-intellij-html-description": "ID of your Cloud Platform Project. If it is not provided, Skaffold will guess it from the image name. For example, given the artifact image name <code>gcr.io/myproject/image</code>, Skaffold will use the <code>myproject</code> GCP project."
         },
         "timeout": {
           "type": "string",
           "description": "amount of time (in seconds) that this build should be allowed to run. See [Cloud Build Reference](https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#resource-build).",
-          "x-intellij-html-description": "<p>amount of time (in seconds) that this build should be allowed to run. See <a href=\"https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#resource-build\">Cloud Build Reference</a>.</p>\n"
+          "x-intellij-html-description": "amount of time (in seconds) that this build should be allowed to run. See <a href=\"https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#resource-build\">Cloud Build Reference</a>."
         }
       },
       "preferredOrder": [
@@ -810,11 +810,11 @@
       ],
       "additionalProperties": false,
       "description": "*beta* describes how to do a remote build on [Google Cloud Build](https://cloud.google.com/cloud-build/docs/). Docker and Jib artifacts can be built on Cloud Build. The `projectId` needs to be provided and the currently logged in user should be given permissions to trigger new builds.",
-      "x-intellij-html-description": "<p><em>beta</em> describes how to do a remote build on <a href=\"https://cloud.google.com/cloud-build/docs/\">Google Cloud Build</a>. Docker and Jib artifacts can be built on Cloud Build. The <code>projectId</code> needs to be provided and the currently logged in user should be given permissions to trigger new builds.</p>\n"
+      "x-intellij-html-description": "<em>beta</em> describes how to do a remote build on <a href=\"https://cloud.google.com/cloud-build/docs/\">Google Cloud Build</a>. Docker and Jib artifacts can be built on Cloud Build. The <code>projectId</code> needs to be provided and the currently logged in user should be given permissions to trigger new builds."
     },
     "HelmConventionConfig": {
       "description": "image config in the syntax of image.repository and image.tag.",
-      "x-intellij-html-description": "<p>image config in the syntax of image.repository and image.tag.</p>\n"
+      "x-intellij-html-description": "image config in the syntax of image.repository and image.tag."
     },
     "HelmDeploy": {
       "required": [
@@ -824,7 +824,7 @@
         "flags": {
           "$ref": "#/definitions/HelmDeployFlags",
           "description": "additional option flags that are passed on the command line to `helm`.",
-          "x-intellij-html-description": "<p>additional option flags that are passed on the command line to <code>helm</code>.</p>\n"
+          "x-intellij-html-description": "additional option flags that are passed on the command line to <code>helm</code>."
         },
         "releases": {
           "items": {
@@ -832,7 +832,7 @@
           },
           "type": "array",
           "description": "a list of Helm releases.",
-          "x-intellij-html-description": "<p>a list of Helm releases.</p>\n"
+          "x-intellij-html-description": "a list of Helm releases."
         }
       },
       "preferredOrder": [
@@ -841,7 +841,7 @@
       ],
       "additionalProperties": false,
       "description": "*beta* uses the `helm` CLI to apply the charts to the cluster.",
-      "x-intellij-html-description": "<p><em>beta</em> uses the <code>helm</code> CLI to apply the charts to the cluster.</p>\n"
+      "x-intellij-html-description": "<em>beta</em> uses the <code>helm</code> CLI to apply the charts to the cluster."
     },
     "HelmDeployFlags": {
       "properties": {
@@ -851,7 +851,7 @@
           },
           "type": "array",
           "description": "additional flags passed on every command.",
-          "x-intellij-html-description": "<p>additional flags passed on every command.</p>\n",
+          "x-intellij-html-description": "additional flags passed on every command.",
           "default": "[]"
         },
         "install": {
@@ -860,7 +860,7 @@
           },
           "type": "array",
           "description": "additional flags passed to (`helm install`).",
-          "x-intellij-html-description": "<p>additional flags passed to (<code>helm install</code>).</p>\n",
+          "x-intellij-html-description": "additional flags passed to (<code>helm install</code>).",
           "default": "[]"
         },
         "upgrade": {
@@ -869,7 +869,7 @@
           },
           "type": "array",
           "description": "additional flags passed to (`helm upgrade`).",
-          "x-intellij-html-description": "<p>additional flags passed to (<code>helm upgrade</code>).</p>\n",
+          "x-intellij-html-description": "additional flags passed to (<code>helm upgrade</code>).",
           "default": "[]"
         }
       },
@@ -880,14 +880,14 @@
       ],
       "additionalProperties": false,
       "description": "additional option flags that are passed on the command line to `helm`.",
-      "x-intellij-html-description": "<p>additional option flags that are passed on the command line to <code>helm</code>.</p>\n"
+      "x-intellij-html-description": "additional option flags that are passed on the command line to <code>helm</code>."
     },
     "HelmFQNConfig": {
       "properties": {
         "property": {
           "type": "string",
           "description": "defines the image config.",
-          "x-intellij-html-description": "<p>defines the image config.</p>\n"
+          "x-intellij-html-description": "defines the image config."
         }
       },
       "preferredOrder": [
@@ -895,19 +895,19 @@
       ],
       "additionalProperties": false,
       "description": "image config to use the FullyQualifiedImageName as param to set.",
-      "x-intellij-html-description": "<p>image config to use the FullyQualifiedImageName as param to set.</p>\n"
+      "x-intellij-html-description": "image config to use the FullyQualifiedImageName as param to set."
     },
     "HelmImageConfig": {
       "properties": {
         "fqn": {
           "$ref": "#/definitions/HelmFQNConfig",
           "description": "image configuration uses the syntax `IMAGE-NAME=IMAGE-REPOSITORY:IMAGE-TAG`.",
-          "x-intellij-html-description": "<p>image configuration uses the syntax <code>IMAGE-NAME=IMAGE-REPOSITORY:IMAGE-TAG</code>.</p>\n"
+          "x-intellij-html-description": "image configuration uses the syntax <code>IMAGE-NAME=IMAGE-REPOSITORY:IMAGE-TAG</code>."
         },
         "helm": {
           "$ref": "#/definitions/HelmConventionConfig",
           "description": "image configuration uses the syntax `IMAGE-NAME.repository=IMAGE-REPOSITORY, IMAGE-NAME.tag=IMAGE-TAG`.",
-          "x-intellij-html-description": "<p>image configuration uses the syntax <code>IMAGE-NAME.repository=IMAGE-REPOSITORY, IMAGE-NAME.tag=IMAGE-TAG</code>.</p>\n"
+          "x-intellij-html-description": "image configuration uses the syntax <code>IMAGE-NAME.repository=IMAGE-REPOSITORY, IMAGE-NAME.tag=IMAGE-TAG</code>."
         }
       },
       "preferredOrder": [
@@ -916,7 +916,7 @@
       ],
       "additionalProperties": false,
       "description": "describes an image configuration.",
-      "x-intellij-html-description": "<p>describes an image configuration.</p>\n"
+      "x-intellij-html-description": "describes an image configuration."
     },
     "HelmImageStrategy": {
       "anyOf": [
@@ -928,7 +928,7 @@
             "fqn": {
               "$ref": "#/definitions/HelmFQNConfig",
               "description": "image configuration uses the syntax `IMAGE-NAME=IMAGE-REPOSITORY:IMAGE-TAG`.",
-              "x-intellij-html-description": "<p>image configuration uses the syntax <code>IMAGE-NAME=IMAGE-REPOSITORY:IMAGE-TAG</code>.</p>\n"
+              "x-intellij-html-description": "image configuration uses the syntax <code>IMAGE-NAME=IMAGE-REPOSITORY:IMAGE-TAG</code>."
             }
           },
           "preferredOrder": [
@@ -941,7 +941,7 @@
             "helm": {
               "$ref": "#/definitions/HelmConventionConfig",
               "description": "image configuration uses the syntax `IMAGE-NAME.repository=IMAGE-REPOSITORY, IMAGE-NAME.tag=IMAGE-TAG`.",
-              "x-intellij-html-description": "<p>image configuration uses the syntax <code>IMAGE-NAME.repository=IMAGE-REPOSITORY, IMAGE-NAME.tag=IMAGE-TAG</code>.</p>\n"
+              "x-intellij-html-description": "image configuration uses the syntax <code>IMAGE-NAME.repository=IMAGE-REPOSITORY, IMAGE-NAME.tag=IMAGE-TAG</code>."
             }
           },
           "preferredOrder": [
@@ -951,19 +951,19 @@
         }
       ],
       "description": "adds image configurations to the Helm `values` file.",
-      "x-intellij-html-description": "<p>adds image configurations to the Helm <code>values</code> file.</p>\n"
+      "x-intellij-html-description": "adds image configurations to the Helm <code>values</code> file."
     },
     "HelmPackaged": {
       "properties": {
         "appVersion": {
           "type": "string",
           "description": "sets the `appVersion` on the chart to this version.",
-          "x-intellij-html-description": "<p>sets the <code>appVersion</code> on the chart to this version.</p>\n"
+          "x-intellij-html-description": "sets the <code>appVersion</code> on the chart to this version."
         },
         "version": {
           "type": "string",
           "description": "sets the `version` on the chart to this semver version.",
-          "x-intellij-html-description": "<p>sets the <code>version</code> on the chart to this semver version.</p>\n"
+          "x-intellij-html-description": "sets the <code>version</code> on the chart to this semver version."
         }
       },
       "preferredOrder": [
@@ -972,7 +972,7 @@
       ],
       "additionalProperties": false,
       "description": "parameters for packaging helm chart (`helm package`).",
-      "x-intellij-html-description": "<p>parameters for packaging helm chart (<code>helm package</code>).</p>\n"
+      "x-intellij-html-description": "parameters for packaging helm chart (<code>helm package</code>)."
     },
     "HelmRelease": {
       "required": [
@@ -983,39 +983,39 @@
         "chartPath": {
           "type": "string",
           "description": "path to the Helm chart.",
-          "x-intellij-html-description": "<p>path to the Helm chart.</p>\n"
+          "x-intellij-html-description": "path to the Helm chart."
         },
         "imageStrategy": {
           "$ref": "#/definitions/HelmImageStrategy",
           "description": "adds image configurations to the Helm `values` file.",
-          "x-intellij-html-description": "<p>adds image configurations to the Helm <code>values</code> file.</p>\n"
+          "x-intellij-html-description": "adds image configurations to the Helm <code>values</code> file."
         },
         "name": {
           "type": "string",
           "description": "name of the Helm release.",
-          "x-intellij-html-description": "<p>name of the Helm release.</p>\n"
+          "x-intellij-html-description": "name of the Helm release."
         },
         "namespace": {
           "type": "string",
           "description": "Kubernetes namespace.",
-          "x-intellij-html-description": "<p>Kubernetes namespace.</p>\n"
+          "x-intellij-html-description": "Kubernetes namespace."
         },
         "overrides": {
           "additionalProperties": {},
           "type": "object",
           "description": "key-value pairs. If present, Skaffold will build a Helm `values` file that overrides the original and use it to call Helm CLI (`--f` flag).",
-          "x-intellij-html-description": "<p>key-value pairs. If present, Skaffold will build a Helm <code>values</code> file that overrides the original and use it to call Helm CLI (<code>--f</code> flag).</p>\n",
+          "x-intellij-html-description": "key-value pairs. If present, Skaffold will build a Helm <code>values</code> file that overrides the original and use it to call Helm CLI (<code>--f</code> flag).",
           "default": "{}"
         },
         "packaged": {
           "$ref": "#/definitions/HelmPackaged",
           "description": "parameters for packaging helm chart (`helm package`).",
-          "x-intellij-html-description": "<p>parameters for packaging helm chart (<code>helm package</code>).</p>\n"
+          "x-intellij-html-description": "parameters for packaging helm chart (<code>helm package</code>)."
         },
         "recreatePods": {
           "type": "boolean",
           "description": "if `true`, Skaffold will send `--recreate-pods` flag to Helm CLI.",
-          "x-intellij-html-description": "<p>if <code>true</code>, Skaffold will send <code>--recreate-pods</code> flag to Helm CLI.</p>\n",
+          "x-intellij-html-description": "if <code>true</code>, Skaffold will send <code>--recreate-pods</code> flag to Helm CLI.",
           "default": "false"
         },
         "setValueTemplates": {
@@ -1024,7 +1024,7 @@
           },
           "type": "object",
           "description": "key-value pairs. If present, Skaffold will try to parse the value part of each key-value pair using environment variables in the system, then send `--set` flag to Helm CLI and append all parsed pairs after the flag.",
-          "x-intellij-html-description": "<p>key-value pairs. If present, Skaffold will try to parse the value part of each key-value pair using environment variables in the system, then send <code>--set</code> flag to Helm CLI and append all parsed pairs after the flag.</p>\n",
+          "x-intellij-html-description": "key-value pairs. If present, Skaffold will try to parse the value part of each key-value pair using environment variables in the system, then send <code>--set</code> flag to Helm CLI and append all parsed pairs after the flag.",
           "default": "{}"
         },
         "setValues": {
@@ -1033,13 +1033,13 @@
           },
           "type": "object",
           "description": "key-value pairs. If present, Skaffold will send `--set` flag to Helm CLI and append all pairs after the flag.",
-          "x-intellij-html-description": "<p>key-value pairs. If present, Skaffold will send <code>--set</code> flag to Helm CLI and append all pairs after the flag.</p>\n",
+          "x-intellij-html-description": "key-value pairs. If present, Skaffold will send <code>--set</code> flag to Helm CLI and append all pairs after the flag.",
           "default": "{}"
         },
         "skipBuildDependencies": {
           "type": "boolean",
           "description": "should build dependencies be skipped.",
-          "x-intellij-html-description": "<p>should build dependencies be skipped.</p>\n",
+          "x-intellij-html-description": "should build dependencies be skipped.",
           "default": "false"
         },
         "values": {
@@ -1048,7 +1048,7 @@
           },
           "type": "object",
           "description": "key-value pairs supplementing the Helm `values` file\".",
-          "x-intellij-html-description": "<p>key-value pairs supplementing the Helm <code>values</code> file&quot;.</p>\n",
+          "x-intellij-html-description": "key-value pairs supplementing the Helm <code>values</code> file&quot;.",
           "default": "{}"
         },
         "valuesFiles": {
@@ -1057,18 +1057,18 @@
           },
           "type": "array",
           "description": "paths to the Helm `values` files\".",
-          "x-intellij-html-description": "<p>paths to the Helm <code>values</code> files&quot;.</p>\n",
+          "x-intellij-html-description": "paths to the Helm <code>values</code> files&quot;.",
           "default": "[]"
         },
         "version": {
           "type": "string",
           "description": "version of the chart.",
-          "x-intellij-html-description": "<p>version of the chart.</p>\n"
+          "x-intellij-html-description": "version of the chart."
         },
         "wait": {
           "type": "boolean",
           "description": "if `true`, Skaffold will send `--wait` flag to Helm CLI.",
-          "x-intellij-html-description": "<p>if <code>true</code>, Skaffold will send <code>--wait</code> flag to Helm CLI.</p>\n",
+          "x-intellij-html-description": "if <code>true</code>, Skaffold will send <code>--wait</code> flag to Helm CLI.",
           "default": "false"
         }
       },
@@ -1090,7 +1090,7 @@
       ],
       "additionalProperties": false,
       "description": "describes a helm release to be deployed.",
-      "x-intellij-html-description": "<p>describes a helm release to be deployed.</p>\n"
+      "x-intellij-html-description": "describes a helm release to be deployed."
     },
     "JSONPatch": {
       "required": [
@@ -1100,18 +1100,18 @@
         "from": {
           "type": "string",
           "description": "source position in the yaml, used for `copy` or `move` operations.",
-          "x-intellij-html-description": "<p>source position in the yaml, used for <code>copy</code> or <code>move</code> operations.</p>\n"
+          "x-intellij-html-description": "source position in the yaml, used for <code>copy</code> or <code>move</code> operations."
         },
         "op": {
           "type": "string",
           "description": "operation carried by the patch: `add`, `remove`, `replace`, `move`, `copy` or `test`.",
-          "x-intellij-html-description": "<p>operation carried by the patch: <code>add</code>, <code>remove</code>, <code>replace</code>, <code>move</code>, <code>copy</code> or <code>test</code>.</p>\n",
+          "x-intellij-html-description": "operation carried by the patch: <code>add</code>, <code>remove</code>, <code>replace</code>, <code>move</code>, <code>copy</code> or <code>test</code>.",
           "default": "replace"
         },
         "path": {
           "type": "string",
           "description": "position in the yaml where the operation takes place. For example, this targets the `dockerfile` of the first artifact built.",
-          "x-intellij-html-description": "<p>position in the yaml where the operation takes place. For example, this targets the <code>dockerfile</code> of the first artifact built.</p>\n",
+          "x-intellij-html-description": "position in the yaml where the operation takes place. For example, this targets the <code>dockerfile</code> of the first artifact built.",
           "examples": [
             "/build/artifacts/0/docker/dockerfile"
           ]
@@ -1119,7 +1119,7 @@
         "value": {
           "type": "object",
           "description": "value to apply. Can be any portion of yaml.",
-          "x-intellij-html-description": "<p>value to apply. Can be any portion of yaml.</p>\n"
+          "x-intellij-html-description": "value to apply. Can be any portion of yaml."
         }
       },
       "preferredOrder": [
@@ -1130,7 +1130,7 @@
       ],
       "additionalProperties": false,
       "description": "patch to be applied by a profile.",
-      "x-intellij-html-description": "<p>patch to be applied by a profile.</p>\n"
+      "x-intellij-html-description": "patch to be applied by a profile."
     },
     "JibGradleArtifact": {
       "properties": {
@@ -1140,7 +1140,7 @@
           },
           "type": "array",
           "description": "additional build flags passed to Gradle.",
-          "x-intellij-html-description": "<p>additional build flags passed to Gradle.</p>\n",
+          "x-intellij-html-description": "additional build flags passed to Gradle.",
           "default": "[]",
           "examples": [
             "[\"--no-build-cache\"]"
@@ -1149,7 +1149,7 @@
         "project": {
           "type": "string",
           "description": "selects which Gradle project to build.",
-          "x-intellij-html-description": "<p>selects which Gradle project to build.</p>\n"
+          "x-intellij-html-description": "selects which Gradle project to build."
         }
       },
       "preferredOrder": [
@@ -1158,7 +1158,7 @@
       ],
       "additionalProperties": false,
       "description": "*alpha* builds images using the [Jib plugin for Gradle](https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin).",
-      "x-intellij-html-description": "<p><em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin\">Jib plugin for Gradle</a>.</p>\n"
+      "x-intellij-html-description": "<em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin\">Jib plugin for Gradle</a>."
     },
     "JibMavenArtifact": {
       "properties": {
@@ -1168,7 +1168,7 @@
           },
           "type": "array",
           "description": "additional build flags passed to Maven.",
-          "x-intellij-html-description": "<p>additional build flags passed to Maven.</p>\n",
+          "x-intellij-html-description": "additional build flags passed to Maven.",
           "default": "[]",
           "examples": [
             "[\"-x\", \"-DskipTests\"]"
@@ -1177,12 +1177,12 @@
         "module": {
           "type": "string",
           "description": "selects which Maven module to build, for a multi module project.",
-          "x-intellij-html-description": "<p>selects which Maven module to build, for a multi module project.</p>\n"
+          "x-intellij-html-description": "selects which Maven module to build, for a multi module project."
         },
         "profile": {
           "type": "string",
           "description": "selects which Maven profile to activate.",
-          "x-intellij-html-description": "<p>selects which Maven profile to activate.</p>\n"
+          "x-intellij-html-description": "selects which Maven profile to activate."
         }
       },
       "preferredOrder": [
@@ -1192,24 +1192,24 @@
       ],
       "additionalProperties": false,
       "description": "*alpha* builds images using the [Jib plugin for Maven](https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin).",
-      "x-intellij-html-description": "<p><em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin\">Jib plugin for Maven</a>.</p>\n"
+      "x-intellij-html-description": "<em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin\">Jib plugin for Maven</a>."
     },
     "KanikoBuild": {
       "properties": {
         "buildContext": {
           "$ref": "#/definitions/KanikoBuildContext",
           "description": "defines where Kaniko gets the sources from.",
-          "x-intellij-html-description": "<p>defines where Kaniko gets the sources from.</p>\n"
+          "x-intellij-html-description": "defines where Kaniko gets the sources from."
         },
         "cache": {
           "$ref": "#/definitions/KanikoCache",
           "description": "configures Kaniko caching. If a cache is specified, Kaniko will use a remote cache which will speed up builds.",
-          "x-intellij-html-description": "<p>configures Kaniko caching. If a cache is specified, Kaniko will use a remote cache which will speed up builds.</p>\n"
+          "x-intellij-html-description": "configures Kaniko caching. If a cache is specified, Kaniko will use a remote cache which will speed up builds."
         },
         "dockerConfig": {
           "$ref": "#/definitions/DockerConfig",
           "description": "describes how to mount the local Docker configuration into the Kaniko pod.",
-          "x-intellij-html-description": "<p>describes how to mount the local Docker configuration into the Kaniko pod.</p>\n"
+          "x-intellij-html-description": "describes how to mount the local Docker configuration into the Kaniko pod."
         },
         "flags": {
           "items": {
@@ -1217,34 +1217,34 @@
           },
           "type": "array",
           "description": "additional flags to be passed to Kaniko command line. See [Kaniko Additional Flags](https://github.com/GoogleContainerTools/kaniko#additional-flags).",
-          "x-intellij-html-description": "<p>additional flags to be passed to Kaniko command line. See <a href=\"https://github.com/GoogleContainerTools/kaniko#additional-flags\">Kaniko Additional Flags</a>.</p>\n",
+          "x-intellij-html-description": "additional flags to be passed to Kaniko command line. See <a href=\"https://github.com/GoogleContainerTools/kaniko#additional-flags\">Kaniko Additional Flags</a>.",
           "default": "[]"
         },
         "image": {
           "type": "string",
           "description": "Docker image used by the Kaniko pod. Defaults to the latest released version of `gcr.io/kaniko-project/executor`.",
-          "x-intellij-html-description": "<p>Docker image used by the Kaniko pod. Defaults to the latest released version of <code>gcr.io/kaniko-project/executor</code>.</p>\n"
+          "x-intellij-html-description": "Docker image used by the Kaniko pod. Defaults to the latest released version of <code>gcr.io/kaniko-project/executor</code>."
         },
         "namespace": {
           "type": "string",
           "description": "Kubernetes namespace. Defaults to current namespace in Kubernetes configuration.",
-          "x-intellij-html-description": "<p>Kubernetes namespace. Defaults to current namespace in Kubernetes configuration.</p>\n"
+          "x-intellij-html-description": "Kubernetes namespace. Defaults to current namespace in Kubernetes configuration."
         },
         "pullSecret": {
           "type": "string",
           "description": "path to the secret key file. See [Kaniko Documentation](https://github.com/GoogleContainerTools/kaniko#running-kaniko-in-a-kubernetes-cluster).",
-          "x-intellij-html-description": "<p>path to the secret key file. See <a href=\"https://github.com/GoogleContainerTools/kaniko#running-kaniko-in-a-kubernetes-cluster\">Kaniko Documentation</a>.</p>\n"
+          "x-intellij-html-description": "path to the secret key file. See <a href=\"https://github.com/GoogleContainerTools/kaniko#running-kaniko-in-a-kubernetes-cluster\">Kaniko Documentation</a>."
         },
         "pullSecretName": {
           "type": "string",
           "description": "name of the Kubernetes secret for pulling the files from the build context and pushing the final image.",
-          "x-intellij-html-description": "<p>name of the Kubernetes secret for pulling the files from the build context and pushing the final image.</p>\n",
+          "x-intellij-html-description": "name of the Kubernetes secret for pulling the files from the build context and pushing the final image.",
           "default": "kaniko-secret"
         },
         "timeout": {
           "type": "string",
           "description": "amount of time (in seconds) that this build is allowed to run. Defaults to 20 minutes (`20m`).",
-          "x-intellij-html-description": "<p>amount of time (in seconds) that this build is allowed to run. Defaults to 20 minutes (<code>20m</code>).</p>\n"
+          "x-intellij-html-description": "amount of time (in seconds) that this build is allowed to run. Defaults to 20 minutes (<code>20m</code>)."
         }
       },
       "preferredOrder": [
@@ -1260,19 +1260,19 @@
       ],
       "additionalProperties": false,
       "description": "*beta* describes how to do an on-cluster build using [Kaniko](https://github.com/GoogleContainerTools/kaniko).",
-      "x-intellij-html-description": "<p><em>beta</em> describes how to do an on-cluster build using <a href=\"https://github.com/GoogleContainerTools/kaniko\">Kaniko</a>.</p>\n"
+      "x-intellij-html-description": "<em>beta</em> describes how to do an on-cluster build using <a href=\"https://github.com/GoogleContainerTools/kaniko\">Kaniko</a>."
     },
     "KanikoBuildContext": {
       "properties": {
         "gcsBucket": {
           "type": "string",
           "description": "CGS bucket to which sources are uploaded by Skaffold. Kaniko will need access to that bucket to download the sources.",
-          "x-intellij-html-description": "<p>CGS bucket to which sources are uploaded by Skaffold. Kaniko will need access to that bucket to download the sources.</p>\n"
+          "x-intellij-html-description": "CGS bucket to which sources are uploaded by Skaffold. Kaniko will need access to that bucket to download the sources."
         },
         "localDir": {
           "$ref": "#/definitions/LocalDir",
           "description": "configures how Kaniko mounts sources directly via an `emptyDir` volume.",
-          "x-intellij-html-description": "<p>configures how Kaniko mounts sources directly via an <code>emptyDir</code> volume.</p>\n"
+          "x-intellij-html-description": "configures how Kaniko mounts sources directly via an <code>emptyDir</code> volume."
         }
       },
       "preferredOrder": [
@@ -1281,14 +1281,14 @@
       ],
       "additionalProperties": false,
       "description": "contains the different fields available to specify a Kaniko build context.",
-      "x-intellij-html-description": "<p>contains the different fields available to specify a Kaniko build context.</p>\n"
+      "x-intellij-html-description": "contains the different fields available to specify a Kaniko build context."
     },
     "KanikoCache": {
       "properties": {
         "repo": {
           "type": "string",
           "description": "a remote repository to store cached layers. If none is specified, one will be inferred from the image name. See [Kaniko Caching](https://github.com/GoogleContainerTools/kaniko#caching).",
-          "x-intellij-html-description": "<p>a remote repository to store cached layers. If none is specified, one will be inferred from the image name. See <a href=\"https://github.com/GoogleContainerTools/kaniko#caching\">Kaniko Caching</a>.</p>\n"
+          "x-intellij-html-description": "a remote repository to store cached layers. If none is specified, one will be inferred from the image name. See <a href=\"https://github.com/GoogleContainerTools/kaniko#caching\">Kaniko Caching</a>."
         }
       },
       "preferredOrder": [
@@ -1296,14 +1296,14 @@
       ],
       "additionalProperties": false,
       "description": "configures Kaniko caching. If a cache is specified, Kaniko will use a remote cache which will speed up builds.",
-      "x-intellij-html-description": "<p>configures Kaniko caching. If a cache is specified, Kaniko will use a remote cache which will speed up builds.</p>\n"
+      "x-intellij-html-description": "configures Kaniko caching. If a cache is specified, Kaniko will use a remote cache which will speed up builds."
     },
     "KubectlDeploy": {
       "properties": {
         "flags": {
           "$ref": "#/definitions/KubectlFlags",
           "description": "additional flags passed to `kubectl`.",
-          "x-intellij-html-description": "<p>additional flags passed to <code>kubectl</code>.</p>\n"
+          "x-intellij-html-description": "additional flags passed to <code>kubectl</code>."
         },
         "manifests": {
           "items": {
@@ -1311,7 +1311,7 @@
           },
           "type": "array",
           "description": "the Kubernetes yaml or json manifests.",
-          "x-intellij-html-description": "<p>the Kubernetes yaml or json manifests.</p>\n",
+          "x-intellij-html-description": "the Kubernetes yaml or json manifests.",
           "default": "[\"k8s/*.yaml\"]"
         },
         "remoteManifests": {
@@ -1320,7 +1320,7 @@
           },
           "type": "array",
           "description": "Kubernetes manifests in remote clusters.",
-          "x-intellij-html-description": "<p>Kubernetes manifests in remote clusters.</p>\n",
+          "x-intellij-html-description": "Kubernetes manifests in remote clusters.",
           "default": "[]"
         }
       },
@@ -1331,7 +1331,7 @@
       ],
       "additionalProperties": false,
       "description": "*beta* uses a client side `kubectl apply` to deploy manifests. You'll need a `kubectl` CLI version installed that's compatible with your cluster.",
-      "x-intellij-html-description": "<p><em>beta</em> uses a client side <code>kubectl apply</code> to deploy manifests. You'll need a <code>kubectl</code> CLI version installed that's compatible with your cluster.</p>\n"
+      "x-intellij-html-description": "<em>beta</em> uses a client side <code>kubectl apply</code> to deploy manifests. You'll need a <code>kubectl</code> CLI version installed that's compatible with your cluster."
     },
     "KubectlFlags": {
       "properties": {
@@ -1341,7 +1341,7 @@
           },
           "type": "array",
           "description": "additional flags passed on creations (`kubectl apply`).",
-          "x-intellij-html-description": "<p>additional flags passed on creations (<code>kubectl apply</code>).</p>\n",
+          "x-intellij-html-description": "additional flags passed on creations (<code>kubectl apply</code>).",
           "default": "[]"
         },
         "delete": {
@@ -1350,7 +1350,7 @@
           },
           "type": "array",
           "description": "additional flags passed on deletions (`kubectl delete`).",
-          "x-intellij-html-description": "<p>additional flags passed on deletions (<code>kubectl delete</code>).</p>\n",
+          "x-intellij-html-description": "additional flags passed on deletions (<code>kubectl delete</code>).",
           "default": "[]"
         },
         "global": {
@@ -1359,7 +1359,7 @@
           },
           "type": "array",
           "description": "additional flags passed on every command.",
-          "x-intellij-html-description": "<p>additional flags passed on every command.</p>\n",
+          "x-intellij-html-description": "additional flags passed on every command.",
           "default": "[]"
         }
       },
@@ -1370,19 +1370,19 @@
       ],
       "additionalProperties": false,
       "description": "additional flags passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).",
-      "x-intellij-html-description": "<p>additional flags passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).</p>\n"
+      "x-intellij-html-description": "additional flags passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete)."
     },
     "KustomizeDeploy": {
       "properties": {
         "flags": {
           "$ref": "#/definitions/KubectlFlags",
           "description": "additional flags passed to `kubectl`.",
-          "x-intellij-html-description": "<p>additional flags passed to <code>kubectl</code>.</p>\n"
+          "x-intellij-html-description": "additional flags passed to <code>kubectl</code>."
         },
         "path": {
           "type": "string",
           "description": "path to Kustomization files.",
-          "x-intellij-html-description": "<p>path to Kustomization files.</p>\n",
+          "x-intellij-html-description": "path to Kustomization files.",
           "default": "."
         }
       },
@@ -1392,25 +1392,25 @@
       ],
       "additionalProperties": false,
       "description": "*beta* uses the `kustomize` CLI to \"patch\" a deployment for a target environment.",
-      "x-intellij-html-description": "<p><em>beta</em> uses the <code>kustomize</code> CLI to &quot;patch&quot; a deployment for a target environment.</p>\n"
+      "x-intellij-html-description": "<em>beta</em> uses the <code>kustomize</code> CLI to &quot;patch&quot; a deployment for a target environment."
     },
     "LocalBuild": {
       "properties": {
         "push": {
           "type": "boolean",
           "description": "should images be pushed to a registry. If not specified, images are pushed only if the current Kubernetes context connects to a remote cluster.",
-          "x-intellij-html-description": "<p>should images be pushed to a registry. If not specified, images are pushed only if the current Kubernetes context connects to a remote cluster.</p>\n"
+          "x-intellij-html-description": "should images be pushed to a registry. If not specified, images are pushed only if the current Kubernetes context connects to a remote cluster."
         },
         "useBuildkit": {
           "type": "boolean",
           "description": "use BuildKit to build Docker images.",
-          "x-intellij-html-description": "<p>use BuildKit to build Docker images.</p>\n",
+          "x-intellij-html-description": "use BuildKit to build Docker images.",
           "default": "false"
         },
         "useDockerCLI": {
           "type": "boolean",
           "description": "use `docker` command-line interface instead of Docker Engine APIs.",
-          "x-intellij-html-description": "<p>use <code>docker</code> command-line interface instead of Docker Engine APIs.</p>\n",
+          "x-intellij-html-description": "use <code>docker</code> command-line interface instead of Docker Engine APIs.",
           "default": "false"
         }
       },
@@ -1421,11 +1421,11 @@
       ],
       "additionalProperties": false,
       "description": "*beta* describes how to do a build on the local docker daemon and optionally push to a repository.",
-      "x-intellij-html-description": "<p><em>beta</em> describes how to do a build on the local docker daemon and optionally push to a repository.</p>\n"
+      "x-intellij-html-description": "<em>beta</em> describes how to do a build on the local docker daemon and optionally push to a repository."
     },
     "LocalDir": {
       "description": "configures how Kaniko mounts sources directly via an `emptyDir` volume.",
-      "x-intellij-html-description": "<p>configures how Kaniko mounts sources directly via an <code>emptyDir</code> volume.</p>\n"
+      "x-intellij-html-description": "configures how Kaniko mounts sources directly via an <code>emptyDir</code> volume."
     },
     "Profile": {
       "required": [
@@ -1438,22 +1438,22 @@
           },
           "type": "array",
           "description": "criteria by which a profile can be auto-activated.",
-          "x-intellij-html-description": "<p>criteria by which a profile can be auto-activated.</p>\n"
+          "x-intellij-html-description": "criteria by which a profile can be auto-activated."
         },
         "build": {
           "$ref": "#/definitions/BuildConfig",
           "description": "replaces the main `build` configuration.",
-          "x-intellij-html-description": "<p>replaces the main <code>build</code> configuration.</p>\n"
+          "x-intellij-html-description": "replaces the main <code>build</code> configuration."
         },
         "deploy": {
           "$ref": "#/definitions/DeployConfig",
           "description": "replaces the main `deploy` configuration.",
-          "x-intellij-html-description": "<p>replaces the main <code>deploy</code> configuration.</p>\n"
+          "x-intellij-html-description": "replaces the main <code>deploy</code> configuration."
         },
         "name": {
           "type": "string",
           "description": "a unique profile name.",
-          "x-intellij-html-description": "<p>a unique profile name.</p>\n",
+          "x-intellij-html-description": "a unique profile name.",
           "examples": [
             "profile-prod"
           ]
@@ -1464,7 +1464,7 @@
           },
           "type": "array",
           "description": "a list of patches applied to the configuration. Patches use the JSON patch notation.",
-          "x-intellij-html-description": "<p>a list of patches applied to the configuration. Patches use the JSON patch notation.</p>\n"
+          "x-intellij-html-description": "a list of patches applied to the configuration. Patches use the JSON patch notation."
         },
         "test": {
           "items": {
@@ -1472,7 +1472,7 @@
           },
           "type": "array",
           "description": "replaces the main `test` configuration.",
-          "x-intellij-html-description": "<p>replaces the main <code>test</code> configuration.</p>\n"
+          "x-intellij-html-description": "replaces the main <code>test</code> configuration."
         }
       },
       "preferredOrder": [
@@ -1485,33 +1485,33 @@
       ],
       "additionalProperties": false,
       "description": "*beta* profiles are used to override any `build`, `test` or `deploy` configuration.",
-      "x-intellij-html-description": "<p><em>beta</em> profiles are used to override any <code>build</code>, <code>test</code> or <code>deploy</code> configuration.</p>\n"
+      "x-intellij-html-description": "<em>beta</em> profiles are used to override any <code>build</code>, <code>test</code> or <code>deploy</code> configuration."
     },
     "ShaTagger": {
       "description": "*beta* tags images with their sha256 digest.",
-      "x-intellij-html-description": "<p><em>beta</em> tags images with their sha256 digest.</p>\n"
+      "x-intellij-html-description": "<em>beta</em> tags images with their sha256 digest."
     },
     "SkaffoldPipeline": {
       "properties": {
         "apiVersion": {
           "type": "string",
           "description": "version of the configuration.",
-          "x-intellij-html-description": "<p>version of the configuration.</p>\n"
+          "x-intellij-html-description": "version of the configuration."
         },
         "build": {
           "$ref": "#/definitions/BuildConfig",
           "description": "describes how images are built.",
-          "x-intellij-html-description": "<p>describes how images are built.</p>\n"
+          "x-intellij-html-description": "describes how images are built."
         },
         "deploy": {
           "$ref": "#/definitions/DeployConfig",
           "description": "describes how images are deployed.",
-          "x-intellij-html-description": "<p>describes how images are deployed.</p>\n"
+          "x-intellij-html-description": "describes how images are deployed."
         },
         "kind": {
           "type": "string",
           "description": "always `Config`.",
-          "x-intellij-html-description": "<p>always <code>Config</code>.</p>\n",
+          "x-intellij-html-description": "always <code>Config</code>.",
           "default": "Config"
         },
         "profiles": {
@@ -1520,7 +1520,7 @@
           },
           "type": "array",
           "description": "*beta* can override be used to `build`, `test` or `deploy` configuration.",
-          "x-intellij-html-description": "<p><em>beta</em> can override be used to <code>build</code>, <code>test</code> or <code>deploy</code> configuration.</p>\n"
+          "x-intellij-html-description": "<em>beta</em> can override be used to <code>build</code>, <code>test</code> or <code>deploy</code> configuration."
         },
         "test": {
           "items": {
@@ -1528,7 +1528,7 @@
           },
           "type": "array",
           "description": "describes how images are tested.",
-          "x-intellij-html-description": "<p>describes how images are tested.</p>\n"
+          "x-intellij-html-description": "describes how images are tested."
         }
       },
       "preferredOrder": [
@@ -1541,29 +1541,29 @@
       ],
       "additionalProperties": false,
       "description": "describes a Skaffold pipeline.",
-      "x-intellij-html-description": "<p>describes a Skaffold pipeline.</p>\n"
+      "x-intellij-html-description": "describes a Skaffold pipeline."
     },
     "TagPolicy": {
       "properties": {
         "dateTime": {
           "$ref": "#/definitions/DateTimeTagger",
           "description": "*beta* tags images with the build timestamp.",
-          "x-intellij-html-description": "<p><em>beta</em> tags images with the build timestamp.</p>\n"
+          "x-intellij-html-description": "<em>beta</em> tags images with the build timestamp."
         },
         "envTemplate": {
           "$ref": "#/definitions/EnvTemplateTagger",
           "description": "*beta* tags images with a configurable template string.",
-          "x-intellij-html-description": "<p><em>beta</em> tags images with a configurable template string.</p>\n"
+          "x-intellij-html-description": "<em>beta</em> tags images with a configurable template string."
         },
         "gitCommit": {
           "$ref": "#/definitions/GitTagger",
           "description": "*beta* tags images with the git tag or commit of the artifact's workspace.",
-          "x-intellij-html-description": "<p><em>beta</em> tags images with the git tag or commit of the artifact's workspace.</p>\n"
+          "x-intellij-html-description": "<em>beta</em> tags images with the git tag or commit of the artifact's workspace."
         },
         "sha256": {
           "$ref": "#/definitions/ShaTagger",
           "description": "*beta* tags images with their sha256 digest.",
-          "x-intellij-html-description": "<p><em>beta</em> tags images with their sha256 digest.</p>\n"
+          "x-intellij-html-description": "<em>beta</em> tags images with their sha256 digest."
         }
       },
       "preferredOrder": [
@@ -1574,7 +1574,7 @@
       ],
       "additionalProperties": false,
       "description": "contains all the configuration for the tagging step.",
-      "x-intellij-html-description": "<p>contains all the configuration for the tagging step.</p>\n"
+      "x-intellij-html-description": "contains all the configuration for the tagging step."
     },
     "TestCase": {
       "required": [
@@ -1584,7 +1584,7 @@
         "image": {
           "type": "string",
           "description": "artifact on which to run those tests.",
-          "x-intellij-html-description": "<p>artifact on which to run those tests.</p>\n",
+          "x-intellij-html-description": "artifact on which to run those tests.",
           "examples": [
             "gcr.io/k8s-skaffold/example"
           ]
@@ -1595,7 +1595,7 @@
           },
           "type": "array",
           "description": "the [Container Structure Tests](https://github.com/GoogleContainerTools/container-structure-test) to run on that artifact.",
-          "x-intellij-html-description": "<p>the <a href=\"https://github.com/GoogleContainerTools/container-structure-test\">Container Structure Tests</a> to run on that artifact.</p>\n",
+          "x-intellij-html-description": "the <a href=\"https://github.com/GoogleContainerTools/container-structure-test\">Container Structure Tests</a> to run on that artifact.",
           "default": "[]",
           "examples": [
             "[\"./test/*\"]"
@@ -1608,7 +1608,7 @@
       ],
       "additionalProperties": false,
       "description": "a list of structure tests to run on images that Skaffold builds.",
-      "x-intellij-html-description": "<p>a list of structure tests to run on images that Skaffold builds.</p>\n"
+      "x-intellij-html-description": "a list of structure tests to run on images that Skaffold builds."
     }
   }
 }
diff --git a/hack/schemas/main.go b/hack/schemas/main.go
index 136c393dec8..fde1bd8ca05 100644
--- a/hack/schemas/main.go
+++ b/hack/schemas/main.go
@@ -246,7 +246,7 @@ func (g *schemaGenerator) newDefinition(name string, t ast.Expr, comment string)
 
 	// Convert to HTML
 	html := string(blackfriday.Run([]byte(description), blackfriday.WithNoExtensions()))
-	def.HTMLDescription = html
+	def.HTMLDescription = strings.TrimSpace(pTags.ReplaceAllString(html, ""))
 
 	return def
 }

From b2a6741233135335edcb86efd19fd5bb2e81a094 Mon Sep 17 00:00:00 2001
From: David Gageot <david@gageot.net>
Date: Fri, 1 Mar 2019 12:31:29 +0100
Subject: [PATCH 7/7] Shorter descriptions

Signed-off-by: David Gageot <david@gageot.net>
---
 docs/content/en/schemas/v1beta6.json | 16 ++++++++--------
 pkg/skaffold/schema/latest/config.go |  8 ++++----
 2 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/docs/content/en/schemas/v1beta6.json b/docs/content/en/schemas/v1beta6.json
index 0d3a930e0f3..cdc96da81c4 100755
--- a/docs/content/en/schemas/v1beta6.json
+++ b/docs/content/en/schemas/v1beta6.json
@@ -1047,8 +1047,8 @@
             "type": "string"
           },
           "type": "object",
-          "description": "key-value pairs supplementing the Helm `values` file\".",
-          "x-intellij-html-description": "key-value pairs supplementing the Helm <code>values</code> file&quot;.",
+          "description": "key-value pairs supplementing the Helm `values` file.",
+          "x-intellij-html-description": "key-value pairs supplementing the Helm <code>values</code> file.",
           "default": "{}"
         },
         "valuesFiles": {
@@ -1056,8 +1056,8 @@
             "type": "string"
           },
           "type": "array",
-          "description": "paths to the Helm `values` files\".",
-          "x-intellij-html-description": "paths to the Helm <code>values</code> files&quot;.",
+          "description": "paths to the Helm `values` files.",
+          "x-intellij-html-description": "paths to the Helm <code>values</code> files.",
           "default": "[]"
         },
         "version": {
@@ -1266,8 +1266,8 @@
       "properties": {
         "gcsBucket": {
           "type": "string",
-          "description": "CGS bucket to which sources are uploaded by Skaffold. Kaniko will need access to that bucket to download the sources.",
-          "x-intellij-html-description": "CGS bucket to which sources are uploaded by Skaffold. Kaniko will need access to that bucket to download the sources."
+          "description": "CGS bucket to which sources are uploaded. Kaniko will need access to that bucket to download the sources.",
+          "x-intellij-html-description": "CGS bucket to which sources are uploaded. Kaniko will need access to that bucket to download the sources."
         },
         "localDir": {
           "$ref": "#/definitions/LocalDir",
@@ -1463,8 +1463,8 @@
             "$ref": "#/definitions/JSONPatch"
           },
           "type": "array",
-          "description": "a list of patches applied to the configuration. Patches use the JSON patch notation.",
-          "x-intellij-html-description": "a list of patches applied to the configuration. Patches use the JSON patch notation."
+          "description": "patches applied to the configuration. Patches use the JSON patch notation.",
+          "x-intellij-html-description": "patches applied to the configuration. Patches use the JSON patch notation."
         },
         "test": {
           "items": {
diff --git a/pkg/skaffold/schema/latest/config.go b/pkg/skaffold/schema/latest/config.go
index 5ddfc386021..8716a73e342 100644
--- a/pkg/skaffold/schema/latest/config.go
+++ b/pkg/skaffold/schema/latest/config.go
@@ -216,7 +216,7 @@ type LocalDir struct{}
 // KanikoBuildContext contains the different fields available to specify
 // a Kaniko build context.
 type KanikoBuildContext struct {
-	// GCSBucket is the CGS bucket to which sources are uploaded by Skaffold.
+	// GCSBucket is the CGS bucket to which sources are uploaded.
 	// Kaniko will need access to that bucket to download the sources.
 	GCSBucket string `yaml:"gcsBucket,omitempty" yamltags:"oneOf=buildContext"`
 
@@ -381,10 +381,10 @@ type HelmRelease struct {
 	// ChartPath is the path to the Helm chart.
 	ChartPath string `yaml:"chartPath,omitempty" yamltags:"required"`
 
-	// ValuesFiles are the paths to the Helm `values` files".
+	// ValuesFiles are the paths to the Helm `values` files.
 	ValuesFiles []string `yaml:"valuesFiles,omitempty"`
 
-	// Values are key-value pairs supplementing the Helm `values` file".
+	// Values are key-value pairs supplementing the Helm `values` file.
 	Values map[string]string `yaml:"values,omitempty,omitempty"`
 
 	// Namespace is the Kubernetes namespace.
@@ -500,7 +500,7 @@ type Profile struct {
 	// Deploy replaces the main `deploy` configuration.
 	Deploy DeployConfig `yaml:"deploy,omitempty"`
 
-	// Patches is a list of patches applied to the configuration.
+	// Patches lists patches applied to the configuration.
 	// Patches use the JSON patch notation.
 	Patches []JSONPatch `yaml:"patches,omitempty"`