restructuring new docs

Author: tclose

new-docs/source/howto/real-example.ipynb renamed to new-docs/source/examples/real-example.ipynb

@@ -1,4 +1,4 @@
-Conditional construction
-========================
+Conditionals and lazy fields
+============================
 
 Work in progress...

new-docs/source/explanation/conditional-lazy.rst

@@ -1,4 +1,4 @@
-Caching
-=======
+Caching and hashing
+===================
 
 Work in progress....

new-docs/source/explanation/hashing-caching.rst

@@ -4,7 +4,7 @@
             "cell_type": "markdown",
             "metadata": {},
             "source": [
-                "# Creating a task package"
+                "# Create a task package"
             ]
         },
         {

new-docs/source/howto/create-task-package.ipynb

@@ -27,35 +27,67 @@ those commands installed on the execution machine, or use software containers
 (e.g., Docker or Singularity) to run them.
 
 
+Tutorials
+---------
+
+* :ref:`Getting started`
+* :ref:`Execution options`
+* :ref:`Python-tasks`
+* :ref:`Shell-tasks`
+* :ref:`Workflows`
+
+Examples
+--------
+
+* :ref:`Real-world example`
+
+How-to Guides
+-------------
+
+* :ref:`Create a task package`
+* :ref:`Port interfaces from Nipype`
+
 Indices and tables
 ------------------
 
 * :ref:`genindex`
 * :ref:`modindex`
 
+.. toctree::
+    :maxdepth: 2
+    :hidden:
+
+    tutorial/getting-started
+    tutorial/advanced-execution
 
 .. toctree::
     :maxdepth: 2
-    :caption: Tutorials
+    :caption: Design
     :hidden:
 
-    tutorial/execution
     tutorial/python
     tutorial/shell
     tutorial/workflow
 
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Examples
+   :hidden:
+
+   examples/real-example
+
 .. toctree::
    :maxdepth: 2
-   :caption: How-to Guides
+   :caption: How-to
    :hidden:
 
-   howto/real-example
    howto/create-task-package
    howto/port-from-nipype
 
 .. toctree::
    :maxdepth: 2
-   :caption: Explanation
+   :caption: In-depth
    :hidden:
 
    explanation/design-approach

new-docs/source/index.rst

@@ -0,0 +1,44 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Execution options"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Execution plugins"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Cache locations"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Environments"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": []
+  }
+ ],
+ "metadata": {
+  "language_info": {
+   "name": "python"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

new-docs/source/tutorial/advanced-execution.ipynb

@@ -4,7 +4,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# Running tasks\n",
+    "# Getting started\n",
     "\n",
     "A *Task* is the basic runnable component in Pydra, and can execute either a Python function,\n",
     "shell command or workflows consisting of combinations of all three types."

new-docs/source/tutorial/execution.ipynb renamed to new-docs/source/tutorial/getting-started.ipynb

@@ -4,7 +4,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# Python-task design"
+    "# Python-tasks"
    ]
   },
   {

new-docs/source/tutorial/python.ipynb

@@ -4,7 +4,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# Shell-task design"
+    "# Shell-tasks"
    ]
   },
   {