--- mitgcm.org/front_content/docs.xml	2011/03/16 19:45:54	1.11
+++ mitgcm.org/front_content/docs.xml	2018/02/15 15:11:42	1.15
@@ -24,40 +24,65 @@
 
     <p>Several documents are currently available:
       <ul>
+	<li> New: <a href="https://mitgcm.readthedocs.io/">Documentation</a>
+ 	  is getting reformatted into sphinx/rst format and hosted at
+	  <a href="https://mitgcm.readthedocs.io/"> readthedocs</a>.
+	  Note that the conversion from the old manual is currently under way
+	  so that this new document is not yet complete.
+	  But a new section
+	  "<a href="https://mitgcm.readthedocs.io/en/latest/contributing/contributing.html">Contributing</a>" has been added.
+	<br /><br /></li>
 
-	<li>The <a href="r2_manual/latest/">
-            Latest </a> online documentation <br /><br /></li>
+        <!--
+    <p>Other available documents:
+    </p>
+      <ul>
+        -->
 
-	<li>The stable online 
-	   <a href="sealion/"> Documentation
-	    </a> (Release-1 version)<br /><br /></li>
-
-	<li> Our 
-            <a href="r2_manual/latest/code_reference/callTree.html" >on-line
-            code browser</a> provides a view of the various
-	    subroutines, functions and variables, 
+	<li>The old format <a href="r2_manual/final/">
+            final </a> online documentation <br /><br /></li>
+
+	<li> Our on-line
+            <a href="http://lxr.mitgcm.org" >code browser</a>
+            provides a view of the various subroutines, functions and variables,
             showing how they are called and used.<br /><br /></li>
 	
-	<li>An MITgcm "Developer's HOWTO" manual is available in multiple formats:
-	  <ul>
-	    <li><a href="./devel_HOWTO/devel_HOWTO_onepage/"> Single-page
-		</a> or 
-	    <a href="./devel_HOWTO/devel_HOWTO_multipage/"> Multi-page
-		</a> (html) </li>
-	    <li><a href="./devel_HOWTO/devel_HOWTO.pdf"> PDF file </a> or
-	    <a href="./devel_HOWTO/devel_HOWTO.ps"> PostScript file
-		</a></li>
-	  </ul>
-	  <br />
-	</li>
+      </ul>
+    </p>
+    <p>And just for reference:
+      <ul>
+	<li> The old
+	   <a href="sealion/"> Release-1
+	    </a> online documentation <br /><br /></li>
+
+	<li> An old MITgcm "Developer's HOWTO" document is available in
+	    <a href="./devel_HOWTO/devel_HOWTO_onepage/"> html </a> or as
+	    <a href="./devel_HOWTO/devel_HOWTO.pdf"> PDF</a> file
+	<br /><br /></li>
 	
+	<li> The old online
+            <a href="r2_manual/latest/code_reference/callTree.html" >code browser</a>
+	<br /><br /></li>
+        <!--
+	<li>New: Documentation is getting reformatted into sphinx/rst format and hosted at
+	  <a href="https://mitgcm.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.
-                   </a>
-       </p>
+    <p>Papers charting the development of MITgcm
+	    <a href="http://mitgcm.org/publications/">can be found here</a>.
+    </p>
 
 	
   </body>