reworked new docs structure

docs/source/explanation/conditional-lazy.rst

@@ -0,0 +1,4 @@
+Conditional construction and lazy evaluation
+=====================================================
+
+Work in progress...

docs/source/howto/create-task-package.rst → docs/source/explanation/splitting-combining.rst

@@ -1,4 +1,4 @@
-Creating a task package
+Splitting and combining
 =======================
 
 Work in progress....

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

@@ -0,0 +1,23 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Creating a task package"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": []
+  }
+ ],
+ "metadata": {
+  "language_info": {
+   "name": "python"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

docs/source/howto/install.ipynb

@@ -0,0 +1,93 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Installation"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Pydra is a pure Python package, which only depends on two packages `attrs` and `fileformats`. Therefore, it is straightforward to install via pip"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {
+    "vscode": {
+     "languageId": "shellscript"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "pip install pydra"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "To install a development version use the `dev` install option"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {
+    "vscode": {
+     "languageId": "shellscript"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "zsh:1: no matches found: pydra[dev]\n",
+      "Note: you may need to restart the kernel to use updated packages.\n"
+     ]
+    }
+   ],
+   "source": [
+    "git clone [email protected]:nipype/pydra.git\n",
+    "pip install -e ./pydra[dev]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {
+    "vscode": {
+     "languageId": "shellscript"
+    }
+   },
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "wf12",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.5"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

docs/source/howto/port-from-nipype.ipynb

@@ -0,0 +1,23 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Port interfaces from Nipype"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": []
+  }
+ ],
+ "metadata": {
+  "language_info": {
+   "name": "python"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

docs/source/index.rst

@@ -112,11 +112,12 @@ Indices and tables
    :caption: Explanation
    :hidden:
 
-   explanation/conditional-logic
+   explanation/splitting-combining
    explanation/typing
    explanation/hashing-caching
+   explanation/conditional-lazy
    explanation/provenance
-   explanation/lazy-evaluation
+
 
 .. toctree::
    :maxdepth: 2

pydra/engine/workflow/base.py

@@ -124,6 +124,11 @@ def construct(
 
         return wf
 
+    @classmethod
+    def clear_cache(cls):
+        """Clear the cache of constructed workflows"""
+        cls._constructed.clear()
+
     def add(self, task_spec: TaskSpec[OutputsType], name=None) -> OutputsType:
         """Add a node to the workflow