diff --git a/docs/modules/user-guide/partials/proc_adding-a-name-to-a-devfile.adoc b/docs/modules/user-guide/partials/proc_adding-a-name-to-a-devfile.adoc
index 0e01d931..6133f393 100644
--- a/docs/modules/user-guide/partials/proc_adding-a-name-to-a-devfile.adoc
+++ b/docs/modules/user-guide/partials/proc_adding-a-name-to-a-devfile.adoc
@@ -19,6 +19,7 @@ Adding a name to a devfile is mandatory. Both `name` and `generateName` are opti
 schemaVersion: 2.0.0
 metadata:
   name: devfile-sample
+  version: 2.0.0
 ----
 
 . To specify a prefix for automatically generated workspace names, define the `generateName` attribute and don't define the `name` attribute. The workspace name will be in the `<generateName>YYYYY` format (for example, `devfile-sample-2y7kp`). `Y` is random `[a-z0-9]` character.
@@ -30,6 +31,7 @@ metadata:
 schemaVersion: 2.0.0
 metadata:
   name: devfile-sample
+  version: 2.0.0
 ----
 
 [NOTE]
diff --git a/docs/modules/user-guide/partials/proc_adding-projects-to-a-devfile.adoc b/docs/modules/user-guide/partials/proc_adding-projects-to-a-devfile.adoc
index 731f8971..1f71f85a 100644
--- a/docs/modules/user-guide/partials/proc_adding-projects-to-a-devfile.adoc
+++ b/docs/modules/user-guide/partials/proc_adding-projects-to-a-devfile.adoc
@@ -23,6 +23,7 @@ This section describes how to add one or more projects to a devfile.
 schemaVersion: 2.0.0
 metadata:
   name: petclinic-dev-environment
+  version: 2.0.0
 projects:
   - name: petclinic
     git:
@@ -40,6 +41,7 @@ projects:
 schemaVersion: 2.0.0
 metadata:
   name: example-devfile
+  version: 2.0.0
 projects:
 - name: frontend
   git:
@@ -96,6 +98,7 @@ source:
 schemaVersion: 2.0.0
 metadata:
   name: my-project-dev
+  version: 2.0.0
 projects:
   - name: my-project-resource
     clonePath: resources/my-project
diff --git a/docs/modules/user-guide/partials/proc_adding-schema-version-to-a-devfile.adoc b/docs/modules/user-guide/partials/proc_adding-schema-version-to-a-devfile.adoc
index 764109c2..341d302e 100644
--- a/docs/modules/user-guide/partials/proc_adding-schema-version-to-a-devfile.adoc
+++ b/docs/modules/user-guide/partials/proc_adding-schema-version-to-a-devfile.adoc
@@ -13,7 +13,12 @@ The `schemaVersion` attribute is mandatory in a devfile.
 ====
 [source,yaml]
 ----
+v2.0
+---
 schemaVersion: 2.0.0
+metadata:
+  name: devfile-sample
+  version: 2.0.0
 ----
 ====
 
@@ -21,4 +26,4 @@ schemaVersion: 2.0.0
 [role="_additional-resources"]
 .Additional resources
 
-* xref:api-reference.adoc[]
\ No newline at end of file
+* xref:api-reference.adoc[]