collection and database stats edits

Author: Sam Kleinman

source/reference/collection-statistics.txt

@@ -69,9 +69,13 @@ Fields
 
 .. stats:: storageSize
 
-   The total amount of storage size. This is equal to the total number
-   of extents allocated to this collection. The ``scale`` argument
-   affects this value.
+   The total amount of storage allocated to this collection for
+   :term:`document` storage.  The ``scale`` argument affects this
+   value. The :stats:`storageSize` does not decrease as you remove or
+   shrink documents.
+
+   .. sum of all extents (no indexes or the $freelist)
+   .. include links to eventual documentation of storage management
 
 .. stats:: numExtents
 

source/reference/database-statistics.txt

@@ -26,7 +26,7 @@ Use the following form:
 
 The above commands are equivalent. Without any arguments,
 :func:`db.stats()` returns values in bytes. To convert the returned
-values to kilobytes, use the following scale argument:
+values to kilobytes, use the scale argument:
 
 .. code-block:: javascript
 
@@ -81,12 +81,13 @@ Fields
 
 .. stats:: storageSize
 
-   The total amount of space allocated to :term:`document` storage for
-   collections in this database. The ``scale`` argument affects this
+   The total amount of space allocated to collections in this database
+   for :term:`document` storage. The ``scale`` argument affects this
    value. The :stats:`storageSize` does not decrease as you remove or
-   shrink documents. 
+   shrink documents.
 
    .. sum of all extents (no indexes or the $freelist)
+   .. include links to eventual documentation of storage management
 
 .. stats:: numExtents