diff --git a/README.md b/README.md
index 96af369..2a5eb38 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,66 @@
 NodeServices
 ========
 
-This repo hosts the Microsoft.AspNet.NodeServices project.
+This repo hosts sources for the `Microsoft.AspNet.AngularServices` and `Microsoft.AspNet.ReactServices` packages, along with samples and the underlying `Microsoft.AspNet.NodeServices project`.
 
 This project is part of ASP.NET 5. You can find samples, documentation and getting started instructions for ASP.NET 5 at the [Home](https://github.com/aspnet/home) repo.
+
+## Trying the samples
+
+To get started,
+
+1. Ensure you have [installed the latest stable version of ASP.NET 5](https://www.asp.net/vnext). Instructions are available for [Windows](http://docs.asp.net/en/latest/getting-started/installing-on-windows.html), [Mac](http://docs.asp.net/en/latest/getting-started/installing-on-mac.html), and [Linux](http://docs.asp.net/en/latest/getting-started/installing-on-linux.html).
+2. Ensure you have [installed a recent version of Node.js](https://nodejs.org/en/). To check this works, open a console prompt, and type `node -v`. It should print a version number.
+3. Ensure you have installed `gulp` globally. You can check if it's there by running `gulp -v`. If you need to install it:
+
+   ```
+   npm install -g gulp
+   ```
+
+3. Clone this repository:
+
+   ```
+   git clone https://github.com/aspnet/NodeServices.git
+   ```
+
+**Using Visual Studio on Windows**
+
+1. Open the solution file, `NodeServices.sln`, in Visual Studio. Wait for it to finish fetching and installing dependencies.
+
+**Using dnx on Windows/Mac/Linux**
+
+1. Ensure you are using a suitable .NET runtime. Currently, this project is tested with version `1.0.0-beta8` on `coreclr`:
+
+   ```
+   dnvm use 1.0.0-beta8 -r coreclr
+   ```
+
+2. In the solution root directory (`NodeServices` - i.e., the directory that contains `NodeServices.sln`), restore the .NET dependencies:
+
+
+   ```
+   cd NodeServices
+   dnu restore
+   ```
+
+3. Change directory to whichever sample you want to run, then restore the Node dependencies. For example:
+
+   ```
+   cd samples/angular/MusicStore/
+   npm install
+   ```
+
+4. Build the project
+
+  ```
+  gulp
+  ```
+
+5. Run the project (and wait until it displays the message `Application started`)
+
+  ```
+  dnx web
+  ```
+
+6. Browse to [`http://localhost:5000/`](http://localhost:5000/)
+