included odo yaml samples in devfile authoring docs (#53)

Co-authored-by: jc-berger <>

Author: jc-berger

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]

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

docs/modules/user-guide/partials/proc_adding-schema-version-to-a-devfile.adoc

@@ -13,12 +13,17 @@ The `schemaVersion` attribute is mandatory in a devfile.
 ====
 [source,yaml]
 ----
+v2.0
+---
 schemaVersion: 2.0.0
+metadata:
+  name: devfile-sample
+  version: 2.0.0
 ----
 ====
 
 
 [role="_additional-resources"]
 .Additional resources
 
-* xref:api-reference.adoc[]
+* xref:api-reference.adoc[]