diff --git a/README.md b/README.md
index 153cb4ca3a..09c54afa69 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,13 @@
 # What is this?
 
-Press the `.` key on any repository or pull request, or swap `.com` with `.dev` in the URL, to go directly to a VS Code environment in your browser.
+The github.dev web-based editor is a lightweight editing experience that runs entirely in your browser. You can navigate files and source code repositories from GitHub, and make and commit code changes.
+
+There are two ways to go directly to a VS Code environment in your browser and start coding:
+
+* Press the . key on any repository or pull request.
+* Swap `.com` with `.dev` in the URL. For example, this repo https://github.com/github/dev becomes http://github.dev/github/dev
+
+Preview the gif below to get a quick demo of github.dev in action.
 
 ![github dev](https://user-images.githubusercontent.com/856858/130119109-4769f2d7-9027-4bc4-a38c-10f297499e8f.gif)