Initial commit

README.md

@@ -1,7 +1,39 @@
+# Try Out Development Containers: Rust
 
-# Contributing
+This is a sample project that lets you try out the **[VS Code Remote - Containers](https://aka.ms/vscode-remote/containers)** extension in a few easy steps.
 
-This project welcomes contributions and suggestions.  Most contributions require you to agree to a
+> **Note:** If you're following the quick start, you can jump to the [Things to try](#things-to-try) section. 
+
+## Setting up the development container
+
+Follow these steps to open this sample in a container:
+
+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).
+
+2. If you're not yet in a development container:
+   - Clone this repository.
+   - Press <kbd>F1</kbd> and select the **Remote-Container: Open Folder in Container...** command.
+   - Select the cloned copy of this folder, wait for the container to start, and try things out!
+
+## Things to try
+
+Once you have this sample opened in a container, you'll be able to work with it like you would locally.
+
+Some things to try:
+
+1. **Edit:**
+   - Open `main.rs`
+   - Try adding some code and check out the language features.
+1. **Terminal:** Press <kbd>ctrl</kbd>+<kbd>shift</kbd>+<kbd>\`</kbd> and type `uname` and other Linux commands from the terminal window.
+1. **Build, Run, and Debug:**
+   - Open `main.rs`
+   - Add a breakpoint (e.g. on line 8).
+   - Press <kbd>F5</kbd> to launch the app in the container.
+   - Once the breakpoint is hit, try hovering over variables, examining locals, and more.
+ 
+## Contributing
+
+This project welcomes contributions and suggestions. Most contributions require you to agree to a
 Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
 the rights to use your contribution. For details, visit https://cla.microsoft.com.
 
@@ -12,3 +44,8 @@ provided by the bot. You will only need to do this once across all repos using o
 This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
 For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
 contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
+
+## License
+
+Copyright © Microsoft Corporation All rights reserved.<br />
+Licensed under the MIT License. See LICENSE in the project root for license information.