Update docs for lifecycle command changes (devcontainers#84)

* Update docs for lifecycle command changes

* Fix up the object types

* Fix up formatting

Author: joshaber

_implementors/json_schema.md

@@ -206,51 +206,101 @@ You may review the current devcontainer.json schemas in the spec repo, which inc
 				"onCreateCommand": {
 					"type": [
 						"string",
-						"array"
+						"array",
+						"object"
 					],
 					"description": "A command to run when creating the container. This command is run after \"initializeCommand\" and before \"updateContentCommand\". If this is a single string, it will be run in a shell. If this is an array of strings, it will be run as a single command without shell.",
 					"items": {
 						"type": "string"
+					},
+					"additionalProperties": {
+						"type": [
+							"string",
+							"array"
+						],
+						"items": {
+							"type": "string"
+						}
 					}
 				},
 				"updateContentCommand": {
 					"type": [
 						"string",
-						"array"
+						"array",
+						"object"
 					],
 					"description": "A command to run when creating the container and rerun when the workspace content was updated while creating the container. This command is run after \"onCreateCommand\" and before \"postCreateCommand\". If this is a single string, it will be run in a shell. If this is an array of strings, it will be run as a single command without shell.",
 					"items": {
 						"type": "string"
+					},
+					"additionalProperties": {
+						"type": [
+							"string",
+							"array"
+						],
+						"items": {
+							"type": "string"
+						}
 					}
 				},
 				"postCreateCommand": {
 					"type": [
 						"string",
-						"array"
+						"array",
+						"object"
 					],
 					"description": "A command to run after creating the container. This command is run after \"updateContentCommand\" and before \"postStartCommand\". If this is a single string, it will be run in a shell. If this is an array of strings, it will be run as a single command without shell.",
 					"items": {
 						"type": "string"
+					},
+					"additionalProperties": {
+						"type": [
+							"string",
+							"array"
+						],
+						"items": {
+							"type": "string"
+						}
 					}
 				},
 				"postStartCommand": {
 					"type": [
 						"string",
-						"array"
+						"array",
+						"object"
 					],
 					"description": "A command to run after starting the container. This command is run after \"postCreateCommand\" and before \"postAttachCommand\". If this is a single string, it will be run in a shell. If this is an array of strings, it will be run as a single command without shell.",
 					"items": {
 						"type": "string"
+					},
+					"additionalProperties": {
+						"type": [
+							"string",
+							"array"
+						],
+						"items": {
+							"type": "string"
+						}
 					}
 				},
 				"postAttachCommand": {
 					"type": [
 						"string",
-						"array"
+						"array",
+						"object"
 					],
 					"description": "A command to run when attaching to the container. This command is run after \"postStartCommand\". If this is a single string, it will be run in a shell. If this is an array of strings, it will be run as a single command without shell.",
 					"items": {
 						"type": "string"
+					},
+					"additionalProperties": {
+						"type": [
+							"string",
+							"array"
+						],
+						"items": {
+							"type": "string"
+						}
 					}
 				},
 				"waitFor": {

_implementors/spec.md

@@ -73,11 +73,11 @@ To apply the metadata together with a user's devcontainer.json at runtime the fo
 | `securityOpt` | `string[]` | Union of all `securityOpt` arrays without duplicates. | x | x |
 | `entrypoint` | `string` | Collected list of all entrypoints. |   | x |
 | `mounts` | `(string \| { type, src, dst })[]` | Collected list of all mountpoints. Conflicts: Last source wins. | x | x |
-| `onCreateCommand` | `string \| string[]` | Collected list of all onCreateCommands. | x |   |
-| `updateContentCommand` | `string \| string[]` | Collected list of all updateContentCommands. | x |   |
-| `postCreateCommand` | `string \| string[]` | Collected list of all postCreateCommands. | x |   |
-| `postStartCommand` | `string \| string[]` | Collected list of all postStartCommands. | x |   |
-| `postAttachCommand` | `string \| string[]` | Collected list of all postAttachCommands. | x |   |
+| `onCreateCommand` | `string \| string[] \| {[key: string]: string \| string[]}` | Collected list of all onCreateCommands. | x |   |
+| `updateContentCommand` | `string \| string[] \| {[key: string]: string \| string[]}` | Collected list of all updateContentCommands. | x |   |
+| `postCreateCommand` | `string \| string[] \| {[key: string]: string \| string[]}` | Collected list of all postCreateCommands. | x |   |
+| `postStartCommand` | `string \| string[] \| {[key: string]: string \| string[]}` | Collected list of all postStartCommands. | x |   |
+| `postAttachCommand` | `string \| string[] \| {[key: string]: string \| string[]}` | Collected list of all postAttachCommands. | x |   |
 | `waitFor` | enum | Last value wins. | x |   |
 | `customizations` | Object of tool-specific customizations. | Merging is left to the tools. | x | x |
 | `containerUser` | `string` | Last value wins. | x |   |