lsst · timj · Jun 10, 2021 · Jun 8, 2021 · Jun 8, 2021 · Jun 8, 2021
diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
@@ -0,0 +1,4 @@
+## Checklist
+
+- [ ] ran Jenkins
+- [ ] added a release note for user-visible changes to `doc/changes`
diff --git a/doc/changes/DM-28649.feature.rst b/doc/changes/DM-28649.feature.rst
@@ -0,0 +1 @@
+``pipetask qgraph`` can now generate a standalone "execution butler" which is a SQLite registry with all the expected outputs pre-filled in registry.  Using this registry allow ``pipetask run`` to execute without touching the main registry whilst still writing file artifacts to the standard location.  It is not yet configured to allow a completely detached processing using a local datastore but this can be changed manually after creation to use a chained datastore.
diff --git a/doc/changes/DM-29384.bugfix.rst b/doc/changes/DM-29384.bugfix.rst
@@ -0,0 +1 @@
+Improve exception handling in ``ExecFixupDataId``
diff --git a/doc/changes/DM-29580.bugfix.rst b/doc/changes/DM-29580.bugfix.rst
@@ -0,0 +1 @@
+Fix config comparison with ``--skip-existing``.
diff --git a/doc/changes/README.rst b/doc/changes/README.rst
@@ -0,0 +1,24 @@
+Recording Changes
+=================
+
+This directory contains "news fragments" which are small files containing text that will be integrated into release notes.
+The files can be in restructured text format or plain text.
+
+Each file should be named like ``<JIRA TICKET>.<TYPE>`` with a file extension defining the markup format.
+The ``<TYPE>`` should be one of:
+
+* ``feature``: New feature
+* ``bugfix``: A bug fix.
+* ``api``: An API change.
+* ``perf``: A performance enhancement.
+* ``doc``: A documentation improvement.
+* ``removal``: An API removal or deprecation.
+* ``other``: Other Changes and Additions of interest to general users.
+* ``misc``: Changes that are of minor interest.
+
+An example file name would therefore look like ``DM-30291.misc.rst``.
+
+If the change concerns specifically the registry or a datastore the news fragment can be placed in the relevant subdirectory.
+
+You can test how the content will be integrated into the release notes by running ``towncrier --draft --version=V.vv``.
+``towncrier`` can be installed from PyPI or conda-forge.
diff --git a/doc/lsst.ctrl.mpexec/CHANGES.rst b/doc/lsst.ctrl.mpexec/CHANGES.rst
@@ -0,0 +1,19 @@
+Multi-Processing Executor v22.0 2021-04-01
+==========================================
+
+New Features
+------------
+
+* ``pipetask run`` can now execute a subset of a graph. This allows a single graph file to be created with an entire workflow and then only part of it to be executed. This is very important for large scale workflow execution. [DM-27667]
+
+Performance Enhancement
+-----------------------
+
+* Multi-processing execution performance has been significantly improved for large graphs. [DM-28418]
+
+Other
+-----
+
+* Ignore ``--input`` instead of rejecting it if it hasn't changed. [DM-28101]
+* The graph file format has been changed from a pickle file to a form that can efficiently be accessed from an object store. This new format has a ``.qgraph`` file extension. [DM-27784]
+* A full URI can now be used to specify the location of the quantum graph. [DM-27682]
diff --git a/doc/lsst.ctrl.mpexec/index.rst b/doc/lsst.ctrl.mpexec/index.rst
@@ -15,8 +15,15 @@ lsst.ctrl.mpexec
 
 .. toctree linking to topics related to using the module's APIs.
 
-.. .. toctree::
-..    :maxdepth: 1
+.. _lsst.ctrl.mpexec-changes:
+
+Changes
+=======
+
+.. toctree::
+   :maxdepth: 1
+
+   CHANGES.rst
 
 .. _lsst.ctrl.mpexec-contributing:
 

diff --git a/pyproject.toml b/pyproject.toml
@@ -0,0 +1,43 @@
+[tool.towncrier]
+    package = "lsst.ctrl.mpexec"
+    package_dir = "python"
+    filename = "doc/lsst.ctrl.mpexec/CHANGES.rst"
+    directory = "doc/changes"
+    title_format = "Multi-Processing Executor {version} {project_date}"
+    issue_format = "`{issue} <https://jira.lsstcorp.org/browse/{issue}>`_"
+
+
+    [[tool.towncrier.type]]
+        directory = "feature"
+        name = "New Features"
+        showcontent = true
+
+    [[tool.towncrier.type]]
+        directory = "api"
+        name = "API Changes"
+        showcontent = true
+
+    [[tool.towncrier.type]]
+        directory = "bugfix"
+        name = "Bug Fixes"
+        showcontent = true
+
+    [[tool.towncrier.type]]
+        directory = "perf"
+        name = "Performance Enhancement"
+        showcontent = true
+
+    [[tool.towncrier.type]]
+        directory = "other"
+        name = "Other Changes and Additions"
+        showcontent = false
+
+    [[tool.towncrier.type]]
+        directory = "misc"
+        name = "Miscellaneous Changes of Minor Interest"
+        showcontent = false
+
+    [[tool.towncrier.type]]
+        directory = "removal"
+        name = "An API Removal or Deprecation"
+        showcontent = false