diff --git a/README.md b/README.md
index 29f7ebd..8093efa 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,46 @@
+# Try Out Development Containers: PHP
-# Contributing
+This is a sample project to go along with the "Try a dev container" quick start for the **[VS Code Remote - Containers](https://aka.ms/vscode-remote/containers)** extension.
-This project welcomes contributions and suggestions. Most contributions require you to agree to a
+**If you are not yet in a development container, [see below](#setting-up-the-development-container).**
+
+## 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 `index.php`
+ - Try adding some code and check out the language features.
+1. **Terminal:** Press ctrl+shift+\` and type `uname` and other Linux commands from the terminal window.
+1. **Build, Run, and Debug:**
+ - Open `index.php`
+ - Add a breakpoint (e.g. on line 4).
+ - Press F5 to launch the app in the container.
+ - Once the breakpoint is hit, try hovering over variables, examining locals, and more.
+1. **Running a server:**
+ - From the terminal, run `php -S localhost:8000`
+ - Press F1 and run the **Remote-Containers: Forward Port from Container...** command.
+ - Select port `8000`.
+ - Click "Open Browser" in the notification that appears to access the web app on this new port.
+ - Look back at the terminal, and you should see the output from your site navigations
+ - Edit the text on line 16 in `index.php` and refresh the page to see the changes immediately take affect
+
+## 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) to get set up.
+
+2. If you're not yet in a development container:
+ - Clone this repository.
+ - Press F1 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!
+
+## 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 +51,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.
+Licensed under the MIT License. See LICENSE in the project root for license information.
\ No newline at end of file