diff --git a/etc/README.md b/etc/README.md
index edc17f87f0a2b9d9613a5be612c8b533ada26db9..2e63795bd2287c3c80634be1fd3975e5bcf315d3 100644
--- a/etc/README.md
+++ b/etc/README.md
@@ -1,6 +1,8 @@
-Examples
+See the [examples](/usgs/nshmp-haz/tree/master/etc/examples) directory as a starting point for command-line use of nshmp-haz.
+
+[Matlab](/usgs/nshmp-haz/tree/master/etc/matlab) shows how to take advantage of the ground motion model implementations in nshmp-haz.
+
+[Peer](/usgs/nshmp-haz/tree/master/etc/peer) is a collection of simple source models that are also a good starting point.
 
-Output files are always placed in a 'results' directory within the directory from which a program was run.
 
-Navigate to 
 
diff --git a/etc/peer/README.md b/etc/peer/README.md
index b0513df9e3e7ec509c0e99cd5fabeefad172e275..5f359e6887c542713f1c4edb1b5b947fe00a0795 100644
--- a/etc/peer/README.md
+++ b/etc/peer/README.md
@@ -1,9 +1,5 @@
-PEER Test Cases
-=========
+#### PEER Test Cases
 
-The PEER PSHA validation project developed a number of source models for the purpose of examining
-the sensitivity of seismic hazard to different PSHA implementations (codes). These test cases are
-used as end-to-end unit tests in __nshmp-haz__. 
+The PEER PSHA validation project developed a number of source models for the purpose of examining the sensitivity of seismic hazard to different PSHA implementations (codes). These test cases are used as end-to-end unit tests in nshmp-haz. 
 
-For more information, including source model specifications, result tables, and summary reports,
-please see the PEER PSHA validation project (TODO: link).
+For more information, including source model specifications, result tables, and summary reports, please see the [PEER](http://peer.berkeley.edu) PSHA validation project (TODO: link; no site as yet).