DOCS-397: fixing build errors

Author: Sam Kleinman

source/administration/production-notes.txt

@@ -43,7 +43,7 @@ production.
 
 Because MongoDB preallocates its database files before using them and
 because MongoDB uses very large files on average, your should
-use the Ext4 and XFS file systems if using the Linux kernel: 
+use the Ext4 and XFS file systems if using the Linux kernel:
 
 - If you use the Ext4 file system, use at least version 2.6.23 of the
   Linux Kernel.
@@ -56,9 +56,10 @@ For MongoDB on Linux use the following recommended configurations:
 - Turn off ``atime`` for the storage volume with the :term:`database
   files <dbpath>`.
 
-- Set file descriptor limit and user process limit to 20,000 (see
-  :ref:`etc/limits` and :term:`ulimit`). A low ulimit will affect
-  MongoDB when under heavy use and will produce weird errors.
+- Set file descriptor limit and user process limit to 20,000,
+  according to the suggestions in :doc:`/administration/ulimit`. A low
+  ulimit will affect MongoDB when under heavy use and will produce
+  weird errors.
 
 - Do not use ``hugepages`` virtual memory pages, MongoDB performs
   better with normal virtual memory pages.
@@ -75,7 +76,7 @@ For MongoDB on Linux use the following recommended configurations:
 
 .. _production-readahead:
 
-Readahead 
+Readahead
 ---------
 
 For random access use patterns set readahead values low, for example
@@ -125,7 +126,7 @@ MongoDB data in swap.
 RAID
 ~~~~
 
-Most MongoDB deployments should use disks backed by RAID-10. 
+Most MongoDB deployments should use disks backed by RAID-10.
 
 RAID-5 and RAID-6 do not typically provide sufficient performance to
 support a MongoDB deployment.
@@ -229,13 +230,13 @@ For example:
 
    iostat -xm 2
 
-Use the mount command to see what device your :term:`data directory
-<dbpath` resides on.
+Use the mount command to see what device your :setting:`data directory
+<dbpath>` resides on.
 
 Key fields from ``iostat``:
 
 - ``%util``: this is the most useful field for a quick check, it
-  indicates what percent of the time the device/drive is in use. 
+  indicates what percent of the time the device/drive is in use.
 
 - ``avgrq-sz``: average request size. Smaller number for this value
   reflect more random IO operations.