DOC - move developer discussions into less visible place

Author: matthew-brett

doc/source/devdiscuss.rst

@@ -0,0 +1,24 @@
+.. -*- mode: rst; fill-column: 79 -*-
+.. ex: set sts=4 ts=4 sw=4 et tw=79:
+  ### ### ### ### ### ### ### ### ### ### ### ### ### ### ### ### ### ### ###
+  #
+  #   See COPYING file distributed along with the NiBabel package for the
+  #   copyright and license terms.
+  #
+  ### ### ### ### ### ### ### ### ### ### ### ### ### ### ### ### ### ### ###
+
+.. _chap_devdiscuss:
+
+*********************
+Developer discussions
+*********************
+
+Some discussions of usecases and other design issues.  Most of these don't apply
+to the current codebase, and are only for discussion of future directions.
+
+.. toctree::
+    :maxdepth: 2
+
+    usecases/index
+    refactoring/index
+    data_pkg_design

doc/source/devguide.rst

@@ -13,11 +13,13 @@
 NiBabel Developer Guidelines
 ****************************
 
+NiBabel source code
+===================
+
 .. toctree::
     :maxdepth: 2
 
     gitwash/index
-    refactoring/index
 
 Documentation
 =============
@@ -86,10 +88,11 @@ Merges
 ------
 
 For easy tracking of what changes were absorbed during merge, we
-advice to enable merge summary within git:
+advise that you enable merge summaries within git:
 
   git-config merge.summary true
 
+See :ref:`configure-git` for more detail.
 
 Changelog
 =========

doc/source/index.rst

@@ -15,6 +15,8 @@ Documentation
 * :ref:`User Documentation <manual>` (manual)
 * :ref:`API Documentation <api>` (comprehensive reference)
 * :ref:`Developer Guidelines <chap_devguide>` (for those who want to contribute)
+* :ref:`Developer discussions <chap_devdiscuss>` (arcane discussions about code
+  design)
 * :ref:`Development Changelog <changelog>` (see what has changed)
 * :ref:`genindex` (access by keywords)
 * :ref:`search` (online and offline full-text search)

doc/source/manual.rst

@@ -8,7 +8,6 @@ NiBabel Manual
 
   installation
   gettingstarted
-  usecases/index
   dicom/dicom
   legal
   changelog