couple of updates to docs

doc/GETTING_STARTED

@@ -153,6 +153,14 @@ The following restrictions currently apply to the IO language:
   Hence, getgroupid should be completely ignored and getgrouprank and
   getgroupsize ignore the group ID parameter passed in.
 
+===== Limitations
+
+The IO language is frozen and no future development will be happening with it,
+so keep the following limitations in mind when using it.
+
+* There is currently no way to specify a "create" flag to open.
+* Variables are expected to be a single lowercase character.
+
 === Network
 
 Our primary network workload generator is via the DUMPI tool

doc/codes-best-practices.tex

@@ -345,6 +345,9 @@ implement -- steps 2--4 are a few lines of code each. Also, LP-IO can be
 used upon encountering a suspend condition to give error specifics (the reverse
 write would occur in the reverse handler in step 3).
 
+Note that ROSS now has a self-suspend API -- the hand-implementation may still
+be used, but it is preferable to use the ROSS version.
+
 \subsection{Stash data needed for reverse computation within event structures}
 
 Writing discrete-event simulations will necessarily involve ``destructive''