documentation improvements for Yard/Ydoc newbies, also relative links…

… replace absolute links where possible so that the user is left with the exact version and not forced to current web docs, in accordance with DOCS-197

README.md

@@ -10,26 +10,33 @@ If you have the source, you can generate the matching documentation  by typing
 
     $ rake ydoc
 
-Then open the file +ydoc/index.html+.
+Then open the file ydoc/index.html in your browser.
 
 # Introduction
 
 This is the 10gen-supported Ruby driver for [MongoDB](http://www.mongodb.org).
 
-This documentation includes other articles of interest, include:
+For the reference manual, use the links in the upper-left and upper-right corners for quick navigation to the following.
 
-1. [A tutorial](http://api.mongodb.org/ruby/current/file.TUTORIAL.html).
-2. [Replica Sets in Ruby](http://api.mongodb.org/ruby/current/file.REPLICA_SETS.html).
-3. [Write Concern in Ruby](http://api.mongodb.org/ruby/current/file.WRITE_CONCERN.html).
-4. [Tailable Cursors in Ruby](http://api.mongodb.org/ruby/current/file.TAILABLE_CURSORS.html).
-5. [Read Preference in Ruby](http://api.mongodb.org/ruby/current/file.READ_PREFERENCE.html).
-6. [GridFS in Ruby](http://api.mongodb.org/ruby/current/file.GridFS.html).
-7. [Frequently Asked Questions](http://api.mongodb.org/ruby/current/file.FAQ.html).
-8. [History](http://api.mongodb.org/ruby/current/file.HISTORY.html).
-9. [Release plan](http://api.mongodb.org/ruby/current/file.RELEASES.html).
-10. [Credits](http://api.mongodb.org/ruby/current/file.CREDITS.html).
+* [Alphabetic Index](_index.html)
+* [Class List](class_list.html)
+* [Method List](method_list.html)
+* [File List](file_list.html)
 
-Here's a quick code sample. Again, see the [MongoDB Ruby Tutorial](http://api.mongodb.org/ruby/current/file.TUTORIAL.html)
+This documentation has other articles of interest, including:
+
+1. [A tutorial](file.TUTORIAL.html).
+2. [Replica Sets in Ruby](file.REPLICA_SETS.html).
+3. [Write Concern in Ruby](file.WRITE_CONCERN.html).
+4. [Tailable Cursors in Ruby](file.TAILABLE_CURSORS.html).
+5. [Read Preference in Ruby](file.READ_PREFERENCE.html).
+6. [GridFS in Ruby](file.GridFS.html).
+7. [Frequently Asked Questions](file.FAQ.html).
+8. [History](file.HISTORY.html).
+9. [Release plan](file.RELEASES.html).
+10. [Credits](file.CREDITS.html).
+
+Here's a quick code sample. Again, see the [MongoDB Ruby Tutorial](file.TUTORIAL.html)
 for much more:
 
     require 'rubygems'

docs/GridFS.md

@@ -88,7 +88,7 @@ Deleting a file is as simple as providing the id:
 
 ### The GridFileSystem class
 
-[GridFileSystem](http://api.mongodb.org/ruby/current/Mongo/GridFileSystem.html) is a light emulation of a file system and therefore has a couple of unique properties. The first is that filenames are assumed to be unique. The second, a consequence of the first, is that files are versioned. To see what this means, let's create a GridFileSystem instance:
+[GridFileSystem](Mongo/GridFileSystem.html) is a light emulation of a file system and therefore has a couple of unique properties. The first is that filenames are assumed to be unique. The second, a consequence of the first, is that files are versioned. To see what this means, let's create a GridFileSystem instance:
 
 #### Saving files
 
@@ -154,5 +154,5 @@ All of the options for storing metadata and saving in safe mode are available fo
 
 ### Advanced Users
 
-Astute code readers will notice that the Grid and GridFileSystem classes are merely thin wrappers around an underlying [GridIO class](http://api.mongodb.org/ruby/current/Mongo/GridIO.html). This means that it's easy to customize the GridFS implementation presented here; just use GridIO for all the low-level work, and build the API you need in an external manager class similar to Grid or GridFileSystem.
+Astute code readers will notice that the Grid and GridFileSystem classes are merely thin wrappers around an underlying [GridIO class](Mongo/GridIO.html). This means that it's easy to customize the GridFS implementation presented here; just use GridIO for all the low-level work, and build the API you need in an external manager class similar to Grid or GridFileSystem.