--- mitgcm.org/front_content/docs.xml	2003/12/06 20:06:58	1.3
+++ mitgcm.org/front_content/docs.xml	2018/02/15 15:11:42	1.15
@@ -22,26 +22,68 @@
 
   
	
 
-    Two forms of documentation are currently available:
+    
Several documents are currently available:
       
+	-  New: Documentation
+ 	  is getting reformatted into sphinx/rst format and hosted at
+	   readthedocs.
+	  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
+	  "Contributing" has been added.
+	
 
 
-	- The complete MITgcm User's
-	    Manual
 
+        
+
+	- The old format 
+            final  online documentation 
 
+
+	-  Our on-line
+            code browser
+            provides a view of the various subroutines, functions and variables,
+            showing how they are called and used.
 
+	
+      
+    
+    And just for reference:
+      
+	-  The old
+	    Release-1
+	     online documentation 
 
 
-	- An MITgcm "Developer's HOWTO" is available in multiple formats:
-	  
-	
 
+	-  An old MITgcm "Developer's HOWTO" document is available in
+	     html  or as
+	     PDF file
+	
 
+	
+	-  The old online
+            code browser
+	
 
+        
 
       
     
+
+    Papers charting the development of MITgcm
+	    can be found here.
+    
+