From e19a63b79f5d727f2117e7e044ba08a71e7f103c Mon Sep 17 00:00:00 2001
From: Neil Vaytet <39047984+nvaytet@users.noreply.github.com>
Date: Wed, 15 Apr 2026 14:04:31 +0200
Subject: [PATCH 1/2] Revise ADDING_PACKAGES.md for essdiffraction package

Updated instructions for adding the essdiffraction package, including new dependencies and file removals.
---
 ADDING_PACKAGES.md | 26 ++++++++++++++++++++++++--
 1 file changed, 24 insertions(+), 2 deletions(-)

diff --git a/ADDING_PACKAGES.md b/ADDING_PACKAGES.md
index 6e6471c22..3029d69e2 100644
--- a/ADDING_PACKAGES.md
+++ b/ADDING_PACKAGES.md
@@ -9,6 +9,7 @@ git clone git@github.com:scipp/essdiffraction.git /tmp/essdiffraction
 cd /tmp/essdiffraction
 git filter-repo --to-subdirectory-filter packages/essdiffraction --tag-rename ':essdiffraction/'
 cd /path/to/ess
+git checkout -b adding-essdiffraction-package
 git remote add essdiffraction /tmp/essdiffraction
 git fetch essdiffraction --tags
 git merge essdiffraction/main --allow-unrelated-histories
@@ -25,8 +26,15 @@ git remote remove essdiffraction
   tag_regex = "^essdiffraction/(?P<version>[vV]?\\d+(?:\\.\\d+)*(?:[._-]?\\w+)*)$"
   git_describe_command = ["git", "describe", "--dirty", "--tags", "--long", "--match", "essdiffraction/*[0-9]*"]
   ```
-- Add `docs` extra with deps from `requirements/docs.in` (minus base deps)
-- Remove unnecessary configurations in the pyproject.toml file. i.e. `tools.codespell`.
+- Add `docs` extra with deps from `requirements/docs.in` (minus base deps), e.g.:
+  ```toml
+  docs = [
+    "autodoc-pydantic",
+    "ipykernel",
+    "ipython!=8.7.0",
+  ]
+  ```
+- Remove unnecessary configurations in the pyproject.toml file. i.e. `[tool.codespell]`, `[tool.ruff]`, `[tool.ruff.lint]`, `[tool.ruff.format]`, etc
 - Delete unnecessary files:
   `tox.ini`, `requirements/`, `.github/`, `.pre-commit-config.yaml`, `MANIFEST.in`, `.gitignore`, `.python-version`.
 
@@ -44,6 +52,9 @@ Docs feature:
 ```toml
 [feature.docs-essdiffraction.pypi-dependencies]
 essdiffraction = { path = "packages/essdiffraction", editable = true, extras = ["test", "docs"] }
+
+[feature.docs-essdiffraction.tasks.docs-essdiffraction]
+cmd = "python -m sphinx -v -b html -d packages/essdiffraction/.docs_doctrees packages/essdiffraction/docs packages/essdiffraction/html"
 ```
 
 Environments (include features for workspace dependencies, e.g. `essreduce`):
@@ -62,4 +73,15 @@ Add a change filter and matrix entry. If the package depends on `essreduce`, inc
 
 ## 5. Run `pixi install` and commit
 
+```bash
+pixi install
+git add -u
+git commit -m "adding essdiffraction package"
+```
+
 ## 6. Push the changes and tags with `essdiffraction` prefix.
+
+```bash
+git push origin adding-essdiffraction-package
+git push origin --tags
+```

From 50c0b914f5354929a8ac51064889092f6e8e7da8 Mon Sep 17 00:00:00 2001
From: Neil Vaytet <39047984+nvaytet@users.noreply.github.com>
Date: Wed, 15 Apr 2026 14:07:09 +0200
Subject: [PATCH 2/2] Update ADDING_PACKAGES.md

---
 ADDING_PACKAGES.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/ADDING_PACKAGES.md b/ADDING_PACKAGES.md
index 3029d69e2..5db9b1670 100644
--- a/ADDING_PACKAGES.md
+++ b/ADDING_PACKAGES.md
@@ -36,7 +36,7 @@ git remote remove essdiffraction
   ```
 - Remove unnecessary configurations in the pyproject.toml file. i.e. `[tool.codespell]`, `[tool.ruff]`, `[tool.ruff.lint]`, `[tool.ruff.format]`, etc
 - Delete unnecessary files:
-  `tox.ini`, `requirements/`, `.github/`, `.pre-commit-config.yaml`, `MANIFEST.in`, `.gitignore`, `.python-version`.
+  `tox.ini`, `requirements/`, `.github/`, `.pre-commit-config.yaml`, `CODE_OF_CONDUCT.md`, `CONTRIBUTING.md`, `LICENSE`, `MANIFEST.in`, `.gitignore`, `.python-version`.
 
 ## 3. Add to `pixi.toml`