DOC - sphinx build cleanup

Author: matthew-brett

doc/source/devel/data_pkg_discuss.rst

@@ -79,7 +79,7 @@ of the package.  Or they might not, that's up to you, the author of the package.
 Package instantiation tag
 =========================
 
-A *tag* is a memorable string that refers to particular pinstance.  It differs
+A *tag* is a memorable string that refers to a particular pinstance.  It differs
 from a revision id only in that there is not likely to be a tag for every
 revision.  It's possible to imagine pinstances without a revision id but with a
 tag, but perhaps it's reasonable to restrict tags to refer to revisions.  A
@@ -342,6 +342,7 @@ Discovery
         raise RuntimeError('It looks like mypkg version 0.3 is not installed')
 
 
+.. rubric:: Footnotes
 
 .. [tag-sources]
 

doc/source/devel/data_pkg_uses.rst

@@ -1,22 +1,14 @@
 .. _data-pkg-uses:
 
-#####################
-Data package usecases
-#####################
+########################################
+Data package usecases and implementation
+########################################
 
-This is a moderate conflation of usecases with some more design definitions and
-discussions.
+********
+Usecases
+********
 
-*************
-Distributions
-*************
-
-Distribution definition
-=======================
-
-A distribution object is an object referring to a package distribution.  It
-has a name and a version.  It may be able to return contents of the
-distribution.  It identifies the type of the distribution.
+We are here working from :doc:`data_pkg_discuss`
 
 Distribution types
 ==================