diff --git a/examples/README.md b/examples/README.md
index 6a4924f5d2..745972f5fe 100644
--- a/examples/README.md
+++ b/examples/README.md
@@ -1,36 +1,47 @@
 # Deno example programs
 
-This module contains small scripts that demonstrate use of Deno and its standard library.
+This module contains small scripts that demonstrate use of Deno and its standard
+module.
 
-You can run these examples by importing them via `deno` command:
+You can run these examples using just their URL or install the example as an
+executable script which references the URL. (Think of installing as creating a
+bookmark to a program.)
 
-```
-> deno https://deno.land/std/examples/echo_server.ts --allow-net
+### A TCP echo server
+
+```shell
+deno https://deno.land/std/examples/echo_server.ts --allow-net
 ```
 
-Some of them are useful CLI programs that can be installed as executables:
-
-`cat.ts` - print file to standard output
+Or
 
+```shell
+deno install echo_server https://deno.land/std/examples/echo_server.ts --allow-net
 ```
-deno install deno_cat https://deno.land/examples.cat.ts --allow-read
+
+### cat - print file to standard output
+
+```shell
+deno install deno_cat https://deno.land/stdexamples/cat.ts --allow-read
 deno_cat file.txt
 ```
 
-`catj.ts` - print flattened JSON to standard output
+### catj - print flattened JSON to standard output
 
-```
-deno install catj https://deno.land/examples/catj.ts --allow-read
+A very useful command by Soheil Rashidi ported to Deno.
+
+```shell
+deno install catj https://deno.land/std/examples/catj.ts --allow-read
 catj example.json
 catj file1.json file2.json
 echo example.json | catj -
 ```
 
-`gist.ts` - easily create and upload Gists
+### gist - easily create and upload Gists
 
 ```
-deno install gist https://deno.land/examples/gist.ts --allow-net --allow-env
 export GIST_TOKEN=ABC # Generate at https://github.com/settings/tokens
+deno install gist https://deno.land/std/examples/gist.ts --allow-net --allow-env
 gist --title "Example gist 1" script.ts
 gist --t "Example gist 2" script2.ts
 ```