README updates

Chuxel · Chuxel · commit 7ab4712ad935 · 2019-04-22T08:36:07.000-07:00
diff --git a/containers/debian-9-git/.devcontainer/devcontainer.json b/containers/debian-9-git/.devcontainer/devcontainer.json
@@ -1,5 +1,5 @@
 {
-	"name": "Debian 9 + Git",
+	"name": "Debian 9 & Git",
 	"dockerFile": "Dockerfile",
 	"appPort": []
 }
diff --git a/containers/debian-9-git/README.md b/containers/debian-9-git/README.md
@@ -1,4 +1,4 @@
-# Debian 9 + Git
+# Debian 9 & Git
 
 ## Summary
 
@@ -10,16 +10,39 @@
 | *Definition type* | Dockerfile |
 | *Languages, platforms* | Any |
 
-## Usage
+## Using this definition with an existing folder
 
-[See here for information on using this definition with an existing project](../../README.md#using-a-definition).
+This definition does require any special steps to use. Just follow these steps:
 
-If you prefer, you can also just look through the contents of the `.devcontainer` folder to understand how to make changes to your own project.
+1. If this is your first time using a development container, please follow the [getting started steps](https://aka.ms/vscode-remote/containers/getting-started) to set up your machine.
 
-If you want to try out the test project instead, run **Remote-Container: Open Folder in Container...** in VS Code and select a cloned copy of the entire folder. You can then start the test program from Debug panel in VS Code.
+2. To use VS Code's copy of this definition:
+   1. Start VS Code and open your project folder.
+   2. Press <kbd>F1</kbd> select and **Remote-Containers: Create Container Configuration File...** from the command palette.
+   3. Select the Debian 9 & Git definition.
+
+3. To use latest-and-greatest copy of this definition from the repository:
+   1. Clone this repository.
+   2. Copy the contents of `containers/debian-9-git/.devcontainer` to the root of your project folder.
+   3. Start VS Code and open your project folder.
+
+4. After following step 2 or 3, the contents of the `.devcontainer` folder in your project can be adapted to meet your needs.
+
+5. Finally, press <kbd>F1</kbd> and run **Remote-Containers: Reopen Folder in Container** to start using the definition.
+
+## Testing the definition
+
+This definition includes some test code that will help you verify it is working as expected on your system. Follow these steps:
+
+1. If this is your first time using a development container, please follow the [getting started steps](https://aka.ms/vscode-remote/containers/getting-started) to set up your machine.
+2. Clone this repository.
+3. Start VS Code, press <kbd>F1</kbd>, and select **Remote-Containers: Open Folder in Container...**
+4. Select the `containers/debian-9-git` folder.
+5. Press <kbd>ctrl</kbd>+<kbd>shift</kbd>+<kbd>`</kbd> and type the following command to verify installation: `apt-get update && apt-get install -y lsb-release && git --version && lsb_release -a`
+6. After lsb_release installs, you should see the Git version and details about the version of Linux in the container.
 
 ## License
 
 Copyright (c) Microsoft Corporation. All rights reserved.
 
-Licensed under the MIT License. See [LICENSE](../../LICENSE). 
+Licensed under the MIT License. See [LICENSE](https://github.com/Microsoft/vscode-dev-containers/blob/master/LICENSE)
diff --git a/containers/dotnetcore-2.1-fsharp/README.md b/containers/dotnetcore-2.1-fsharp/README.md
@@ -12,7 +12,7 @@
 
 ## Using this definition with an existing folder
 
-When using this development container, it's important to note that only the integrated terminal is currently supported in Dev Containers. You may need to modify `launch.json` configurations to include the following value if an external console is used.
+Note that only the integrated terminal is supported by the Remote - Containers extension. You may need to modify `launch.json` configurations to include the following value if an external console is used.
 
 ```json
 "console": "integratedTerminal"
diff --git a/containers/dotnetcore-2.1/README.md b/containers/dotnetcore-2.1/README.md
@@ -12,7 +12,7 @@
 
 ## Using this definition with an existing folder
 
-When using this development container, it's important to note that only the integrated terminal is currently supported in Dev Containers. You may need to modify `launch.json` configurations to include the following value if an external console is used.
+Note that only the integrated terminal is supported by the Remote - Containers extension. You may need to modify `launch.json` configurations to include the following value if an external console is used.
 
 ```json
 "console": "integratedTerminal"
diff --git a/containers/dotnetcore-latest-fsharp/README.md b/containers/dotnetcore-latest-fsharp/README.md
@@ -12,7 +12,7 @@
 
 ## Using this definition with an existing folder
 
-When using this development container, it's important to note that only the integrated terminal is currently supported in Dev Containers. You may need to modify `launch.json` configurations to include the following value if an external console is used.
+Note that only the integrated terminal is supported by the Remote - Containers extension. You may need to modify `launch.json` configurations to include the following value if an external console is used.
 
 ```json
 "console": "integratedTerminal"
diff --git a/containers/dotnetcore-latest/README.md b/containers/dotnetcore-latest/README.md
@@ -12,7 +12,7 @@
 
 ## Using this definition with an existing folder
 
-When using this development container, it's important to note that only the integrated terminal is currently supported in Dev Containers. You may need to modify `launch.json` configurations to include the following value if an external console is used.
+Note that only the integrated terminal is supported by the Remote - Containers extension. You may need to modify `launch.json` configurations to include the following value if an external console is used.
 
 ```json
 "console": "integratedTerminal"
diff --git a/containers/java-8-maven/README.md b/containers/java-8-maven/README.md
@@ -11,7 +11,8 @@
 | *Languages, platforms* | Java, Maven |
 
 ## Using this definition with an existing folder
-When using this development container, it's important to note that only the integrated terminal is currently supported in Dev Containers. You may need to modify `launch.json` configurations to include the following value if an external console is used.
+
+Note that only the integrated terminal is supported by the Remote - Containers extension. You may need to modify `launch.json` configurations to include the following value if an external console is used.
 
 ```json
 "console": "integratedTerminal"
diff --git a/containers/ubuntu-18.04-git/.devcontainer/devcontainer.json b/containers/ubuntu-18.04-git/.devcontainer/devcontainer.json
@@ -1,5 +1,5 @@
 {
-	"name": "Ubuntu 18.04 + Git",
+	"name": "Ubuntu 18.04 & Git",
 	"dockerFile": "Dockerfile",
 	"appPort": []
 }
diff --git a/containers/ubuntu-18.04-git/README.md b/containers/ubuntu-18.04-git/README.md
@@ -1,4 +1,4 @@
-# Ubuntu 18.04 + Git
+# Ubuntu 18.04 & Git
 
 ## Summary
 
@@ -10,16 +10,39 @@
 | *Definition type* | Dockerfile |
 | *Languages, platforms* | Any |
 
-## Usage
+## Using this definition with an existing folder
 
-[See here for information on using this definition with an existing project](../../README.md#using-a-definition).
+This definition does require any special steps to use. Just follow these steps:
 
-If you prefer, you can also just look through the contents of the `.devcontainer` folder to understand how to make changes to your own project.
+1. If this is your first time using a development container, please follow the [getting started steps](https://aka.ms/vscode-remote/containers/getting-started) to set up your machine.
 
-If you want to try out the test project instead, run **Remote-Container: Open Folder in Container...** in VS Code and select a cloned copy of the entire folder. You can then start the test program from Debug panel in VS Code.
+2. To use VS Code's copy of this definition:
+   1. Start VS Code and open your project folder.
+   2. Press <kbd>F1</kbd> select and **Remote-Containers: Create Container Configuration File...** from the command palette.
+   3. Select the Ubuntu 18.04 & Git definition.
+
+3. To use latest-and-greatest copy of this definition from the repository:
+   1. Clone this repository.
+   2. Copy the contents of `containers/ubuntu-18.04-git/.devcontainer` to the root of your project folder.
+   3. Start VS Code and open your project folder.
+
+4. After following step 2 or 3, the contents of the `.devcontainer` folder in your project can be adapted to meet your needs.
+
+5. Finally, press <kbd>F1</kbd> and run **Remote-Containers: Reopen Folder in Container** to start using the definition.
+
+## Testing the definition
+
+This definition includes some test code that will help you verify it is working as expected on your system. Follow these steps:
+
+1. If this is your first time using a development container, please follow the [getting started steps](https://aka.ms/vscode-remote/containers/getting-started) to set up your machine.
+2. Clone this repository.
+3. Start VS Code, press <kbd>F1</kbd>, and select **Remote-Containers: Open Folder in Container...**
+4. Select the `containers/ubuntu-18.04-git` folder.
+5. Press <kbd>ctrl</kbd>+<kbd>shift</kbd>+<kbd>`</kbd> and type the following command to verify installation: `apt-get update && apt-get install -y lsb-release && git --version && lsb_release -a`
+6. After lsb_release installs, you should see the Git version and details about the version of Linux in the container.
 
 ## License
 
 Copyright (c) Microsoft Corporation. All rights reserved.
 
-Licensed under the MIT License. See [LICENSE](../../LICENSE). 
+Licensed under the MIT License. See [LICENSE](https://github.com/Microsoft/vscode-dev-containers/blob/master/LICENSE)

Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`{`
`2`		`- "name": "Debian 9 + Git",`
	`2`	`+ "name": "Debian 9 & Git",`
`3`	`3`	`"dockerFile": "Dockerfile",`
`4`	`4`	`"appPort": []`
`5`	`5`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`{`
`2`		`- "name": "Ubuntu 18.04 + Git",`
	`2`	`+ "name": "Ubuntu 18.04 & Git",`
`3`	`3`	`"dockerFile": "Dockerfile",`
`4`	`4`	`"appPort": []`
`5`	`5`	`}`