README corrections

Chuxel · Chuxel · commit b10d3f6eae1e · 2019-04-21T20:28:43.000-07:00
diff --git a/containers/cpp/README.md b/containers/cpp/README.md
@@ -19,7 +19,7 @@ This definition does require any special steps to use. Just follow these steps:
 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 Dart definition.
+   3. Select the C++ definition.
 
 3. To use latest-and-greatest copy of this definition from the repository:
    1. Clone this repository.
diff --git a/containers/dart/README.md b/containers/dart/README.md
@@ -38,9 +38,9 @@ This definition includes some test code that will help you verify it is working
 2. Clone this repository.
 3. Start VS Code, press <kbd>F1</kbd>, and select **Remote-Containers: Open Folder in Container...**
 4. Select the `containers/dart` folder.
-5. After the folder has opened in the container, press <kbd>F5</kbd> to start the project. This will automatically run `pub get` and build the code be for starting it.
+5. After the folder has opened in the container, press <kbd>F5</kbd> to start the project. This will automatically run `pub get` and build the code before starting it.
 6. Once the project is running, press <kbd>F1</kbd> and select **Remote-Containers: Forward Port...**
-7. Select port 8080 and open `http://localhost:8080` in a browser.
+7. Select port 8080 and click the "Open Browser" button in the notification that appears.
 8. You should see "Hello remote world!" after the page loads.
 9. From here, you can add breakpoints or edit the contents of the `test-project` folder to do further testing.
 
diff --git a/containers/dotnetcore-2.1-fsharp/README.md b/containers/dotnetcore-2.1-fsharp/README.md
@@ -25,7 +25,7 @@ Beyond that, just follow these steps to use the definition:
 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 Dart definition.
+   3. Select the F# (.NET Core 2.1) definition.
 
 3. To use latest-and-greatest copy of this definition from the repository:
    1. Clone this repository.
diff --git a/containers/dotnetcore-2.1/README.md b/containers/dotnetcore-2.1/README.md
@@ -25,7 +25,7 @@ Beyond that, just follow these steps to use the definition:
 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 Dart definition.
+   3. Select the C# (.NET Core 2.1) definition.
 
 3. To use latest-and-greatest copy of this definition from the repository:
    1. Clone this repository.
@@ -47,7 +47,7 @@ This definition includes some test code that will help you verify it is working
 5. After the folder has opened in the container, if prompted to restore packages in a notification, click "Restore".
 6. After packages are restored, press <kbd>F5</kbd> to start the project.
 7. Once the project is running, press <kbd>F1</kbd> and select **Remote-Containers: Forward Port...**
-8. Select port 8090 and open `http://localhost:8090` in a browser.
+8. Select port 8090 and click the "Open Browser" button in the notification that appears.
 9. You should see "Hello remote world from ASP.NET Core!" after the page loads.
 10. From here, you can add breakpoints or edit the contents of the `test-project` folder to do further testing.
 
diff --git a/containers/dotnetcore-latest-fsharp/README.md b/containers/dotnetcore-latest-fsharp/README.md
@@ -25,7 +25,7 @@ Beyond that, just follow these steps to use the definition:
 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 Dart definition.
+   3. Select the F# (.NET Core Latest) definition.
 
 3. To use latest-and-greatest copy of this definition from the repository:
    1. Clone this repository.
diff --git a/containers/dotnetcore-latest/README.md b/containers/dotnetcore-latest/README.md
@@ -25,7 +25,7 @@ Beyond that, just follow these steps to use the definition:
 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 Dart definition.
+   3. Select the C# (.NET Core Latest) definition.
 
 3. To use latest-and-greatest copy of this definition from the repository:
    1. Clone this repository.
@@ -47,7 +47,7 @@ This definition includes some test code that will help you verify it is working
 5. After the folder has opened in the container, if prompted to restore packages in a notification, click "Restore".
 6. After packages are restored, press <kbd>F5</kbd> to start the project.
 7. Once the project is running, press <kbd>F1</kbd> and select **Remote-Containers: Forward Port...**
-8. Select port 8090 and open `http://localhost:8090` in a browser.
+8. Select port 8090 and click the "Open Browser" button in the notification that appears.
 9. You should see "Hello remote world from ASP.NET Core!" after the page loads.
 10. From here, you can add breakpoints or edit the contents of the `test-project` folder to do further testing.
 
diff --git a/containers/go/README.md b/containers/go/README.md
@@ -19,7 +19,7 @@ This definition does require any special steps to use. Just follow these steps:
 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 Dart definition.
+   3. Select the Go definition.
 
 3. To use latest-and-greatest copy of this definition from the repository:
    1. Clone this repository.
@@ -38,8 +38,9 @@ This definition includes some test code that will help you verify it is working
 2. Clone this repository.
 3. Start VS Code, press <kbd>F1</kbd>, and select **Remote-Containers: Open Folder in Container...**
 4. Select the `containers/go` folder.
-5. After the folder has opened in the container, press <kbd>F5</kbd> to start the project. You should see "Hello remote world!" in the debug console.
-6. From here, you can add breakpoints or edit the contents of the `test-project` folder to do further testing.
+5. After the folder has opened in the container, press <kbd>F5</kbd> to start the project.
+6. You should see "Hello remote world!" in the Debug Console after the program executes.
+7. From here, you can add breakpoints or edit the contents of the `test-project` folder to do further testing.
 
 ## License
 
diff --git a/containers/java-8-maven/README.md b/containers/java-8-maven/README.md
@@ -10,15 +10,45 @@
 | *Definition type* | Dockerfile |
 | *Languages, platforms* | Java, Maven |
 
-## Usage
+## 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.
 
-[See here for information on using this definition with an existing project](../../README.md#using-a-definition).
+```json
+"console": "integratedTerminal"
+```
 
-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.
-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.
+Beyond that, just follow these steps to use the definition:
+
+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. 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 Java 8 & Maven definition.
+
+3. To use latest-and-greatest copy of this definition from the repository:
+   1. Clone this repository.
+   2. Copy the contents of `containers/java-8-maven/.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/java-8-maven` folder.
+5. After the folder has opened in the container, press <kbd>F5</kbd> to start the project.
+6. You should see "Hello Remote World!" in the a Debug Console after the program executes.
+7. From here, you can add breakpoints or edit the contents of the `test-project` folder to do further testing.
 
 ## 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).
