more SME feedback

Author: jc-berger

Diff for: docs/modules/user-guide/partials/proc_adding-commands-to-a-devfile.adoc

@@ -74,7 +74,7 @@ A devfile allows you to specify commands to be available for execution in a work
 |commands
 |string
 |no
-|The exec commands that constitute the composite command.
+|The exec commands that constitute the composite command and chains multiple commands together. 
 
 |parallel
 |boolean
@@ -106,7 +106,7 @@ A devfile allows you to specify commands to be available for execution in a work
 |boolean
 |no
 |Identifies if it is the default command to run. Only one default command can be defined for each group.
-|=== 
+|===
 
 .Prerequisites
 

Diff for: docs/modules/user-guide/partials/proc_adding-components-to-a-devfile.adoc

@@ -2,7 +2,7 @@
 = Adding components to a devfile
 
 [role="_abstract"]
-Each component in a single devfile must have a unique name and use the `container` object. See the following tables for component properties in a devfile:
+Each component in a single devfile must have a unique name and use one of the objects: `container`, `kubernetes`, `openshift`, or `volume`. See the following tables for component properties in a devfile:
 
 .Component object
 [cols="1,1,1,1"]
@@ -79,7 +79,7 @@ Each component in a single devfile must have a unique name and use the `containe
 |exposure
 |string
 |no
-|Use the following attributes to describe how to expose the endpoints on the network: `public`, `internal`, `none`.
+|Use the following attributes to describe how to expose the endpoints on the network: `public`, `internal`, `none`. If not specified, the default attribute is `public`.
 
 |path
 |string
@@ -89,7 +89,7 @@ Each component in a single devfile must have a unique name and use the `containe
 |protocol
 |string
 |no
-|Use the following attributes to describe the application and transport protocols of the traffic that goes through the endpoint: `http`, `https`, `ws`, `wss`, `tcp`, `udp`.
+|Use the following attributes to describe the application and transport protocols of the traffic that goes through the endpoint: `http`, `https`, `ws`, `wss`, `tcp`, `udp`. If not specified, the default attribute is `public`. 
 
 |secure
 |boolean

Diff for: docs/modules/user-guide/partials/proc_adding-event-bindings.adoc

@@ -2,7 +2,7 @@
 = Adding event bindings
 
 [role="_abstract"]
-This section describes how to add an event to a v2.x devfile. An event specified in a v1.x devfile still works in a v2.x devfile. An event can have three different type of objects:
+This section describes how to add an event to a v2.x devfile. An event can have three different type of objects:
 
 . preStartObject
 . postStartObject

Diff for: docs/modules/user-guide/partials/proc_adding-projects-to-a-devfile.adoc

@@ -2,13 +2,7 @@
 = Adding projects to a devfile
 
 [role="_abstract"]
-This section describes how to add one or more projects to a devfile. Each starter project can contain three different objects:
-
-* git
-* github
-* zip
-
-See the following tables for project properties in a devfile:
+This section describes how to add one or more projects to a devfile. Each starter project can contain either a `git` or `zip` object. See the following tables for project properties in a devfile:
 
 .starterProject object
 [cols="1,1,1,1"]
@@ -17,7 +11,7 @@ See the following tables for project properties in a devfile:
 
 |name
 |string
-|no
+|yes
 |The name of your devfile.
 
 |description
@@ -37,51 +31,15 @@ See the following tables for project properties in a devfile:
 |===
 |Key |Type| Required| Description
 
-|location
+|checkoutFrom
 |string
 |no
 |The location of your git repository.
 
-|branch
+|remotes
 |string
 |no
 |The branch that you use.
-
-|spareCheckoutDir
-|string
-|no
-|The directory that you use when you pull from your repository.
-
-|startPoint
-|string
-|no
-|The tag or commit from where you start.
-|===
-
-.githubObject
-[cols="1,1,1,1"]
-|===
-|Key |Type| Required| Description
-
-|location
-|string
-|no
-|The location of your git repository.
-
-|branch
-|string
-|no
-|The branch that you use.
-
-|spareCheckoutDir
-|string
-|no
-|The directory that you use when you pull from your repository.
-
-|startPoint
-|string
-|no
-|The tag or commit from where you start.
 |===
 
 .zipObject
@@ -93,11 +51,6 @@ See the following tables for project properties in a devfile:
 |string
 |no
 |The location of your zip.
-
-|spareCheckoutDir
-|string
-|no
-|The directory that you use when you pull from your repository.
 |===
 
 .Prerequisites