--- mitgcm.org/front_content/docs.xml	2011/03/16 19:45:54	1.11
+++ mitgcm.org/front_content/docs.xml	2018/01/19 17:20:19	1.14
@@ -26,11 +26,11 @@
       <ul>
 
 	<li>The <a href="r2_manual/latest/">
-            Latest </a> online documentation <br /><br /></li>
+            most recent </a> online documentation <br /><br /></li>
 
-	<li>The stable online 
-	   <a href="sealion/"> Documentation
-	    </a> (Release-1 version)<br /><br /></li>
+	<li>The
+	   <a href="sealion/"> Release-1
+	    </a> online documentation (stable) <br /><br /></li>
 
 	<li> Our 
             <a href="r2_manual/latest/code_reference/callTree.html" >on-line
@@ -48,14 +48,25 @@
 	    <a href="./devel_HOWTO/devel_HOWTO.ps"> PostScript file
 		</a></li>
 	  </ul>
-	  <br />
-	</li>
+	<br /></li>
 	
+	<li>New: Documentation is getting reformatted into sphinx/rst format and hosted at
+	  <a href="https://mitgcm-example.readthedocs.io/en/latest/"> readthedocs</a>.
+	  Note that the conversion from the old manual is currently under way 
+	  so that this new document is not yet complete.
+	  Both the new documentation source files and the associated 
+	  -- but currently frozen -- MITgcm code
+          are available from a single
+	  <a href="https://github.com/altMITgcm/MITgcm"> prototype repository</a>
+          on GitHub. This repository is used to explore a transition from CVS to Git
+	  which is planned to happen soon.
+	<br /><br /></li>
+
       </ul>
     </p>
 
        <p>Papers charting the development of MITgcm <a
-             href="http://paoc.mit.edu/cmi/publications.htm">can be found here.
+             href="http://mitgcm.org/publications/">can be found here.
                    </a>
        </p>