docs: create TR-015 from AmpForm's spin-alignment (#119)

* build: install ComPWA/ampform@98de70f from main branch
* ci: ignore vscode.dev
* ci: run linkcheck on Python 3.8

.cspell.json

@@ -116,6 +116,7 @@
         "axvline",
         "azim",
         "bdist",
+        "bgcolor",
         "boldsymbol",
         "celltoolbar",
         "clim",
@@ -146,6 +147,7 @@
         "facecolors",
         "figsize",
         "filterwarnings",
+        "fontcolor",
         "fontsize",
         "getitem",
         "getsource",
@@ -175,6 +177,7 @@
         "linkcheck",
         "linspace",
         "livereveal",
+        "marangotto",
         "markdownlint",
         "mathbb",
         "mathcal",

.github/workflows/linkcheck.yml

@@ -17,14 +17,14 @@ jobs:
     runs-on: ubuntu-20.04
     steps:
       - uses: actions/checkout@v2
-      - name: Set up Python 3.7
+      - name: Set up Python 3.8
         uses: actions/setup-python@v2
         with:
-          python-version: "3.7"
+          python-version: "3.8"
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install -c .constraints/py3.7.txt -e .[doc]
+          pip install -c .constraints/py3.8.txt -e .[doc]
           sudo apt-get -y install graphviz pandoc
       - name: Check external links
         working-directory: docs

.pre-commit-config.yaml

@@ -41,7 +41,7 @@ repos:
           )$
 
   - repo: https://github.com/ComPWA/repo-maintenance
-    rev: 0.0.111
+    rev: 0.0.112
     hooks:
       - id: check-dev-files
         args:

docs/bibliography.bib

@@ -96,6 +96,20 @@ @misc{kutschkeAngularDistributionCookbook1996
   url = {https://home.fnal.gov/~kutschke/Angdist/angdist.ps}
 }
 
+@article{marangottoHelicityAmplitudesGeneric2020,
+  title = {Helicity {{Amplitudes}} for {{Generic Multibody Particle Decays Featuring Multiple Decay Chains}}},
+  author = {Marangotto, Daniele},
+  editor = {Vagnozzi, Sunny},
+  year = {2020},
+  month = dec,
+  journal = {Advances in High Energy Physics},
+  volume = {2020},
+  pages = {1--15},
+  issn = {1687-7365, 1687-7357},
+  doi = {10.1155/2020/6674595},
+  url = {https://www.hindawi.com/journals/ahep/2020/6674595/}
+}
+
 @book{martinCleanCodeHandbook2009,
   title = {Clean {{Code}}: {{A Handbook}} of {{Agile Software Craftsmanship}}},
   shorttitle = {Clean Code},
@@ -116,6 +130,23 @@ @misc{meyerMatrixTutorial2008
   url = {http://www.curtismeyer.com/talks/PWA_Munich_KMatrix.pdf}
 }
 
+@article{mikhasenkoDalitzplotDecompositionThreebody2020,
+  title = {Dalitz-Plot Decomposition for Three-Body Decays},
+  author = {Mikhasenko, M. and Albaladejo, M. and Bibrzycki, Ł. and {Fernandez-Ramirez}, C. and Mathieu, V. and Mitchell, S. and Pappagallo, M. and Pilloni, A. and Winney, D. and Skwarnicki, T. and Szczepaniak, A. P.},
+  year = {2020},
+  month = feb,
+  journal = {Physical Review D},
+  volume = {101},
+  number = {3},
+  eprint = {1910.04566},
+  eprinttype = {arxiv},
+  pages = {034033},
+  issn = {2470-0010, 2470-0029},
+  doi = {10.1103/PhysRevD.101.034033},
+  url = {https://journals.aps.org/prd/abstract/10.1103/PhysRevD.101.034033},
+  archiveprefix = {arXiv}
+}
+
 @book{percivalTestDrivenDevelopmentPython2017,
   title = {Test-{{Driven Development}} with {{Python}}: {{Obey}} the {{Testing Goat}}: {{Using Django}}, {{Selenium}}, and {{JavaScript}}},
   shorttitle = {Test-Driven Development with {{Python}}},
@@ -168,4 +199,16 @@ @book{slatkinEffectivePython902019
   annotation = {OCLC: 1127093006}
 }
 
+@article{wangNovelMethodTest2020,
+  title = {A Novel Method to Test Particle Ordering and Final State Alignment in Helicity Formalism},
+  author = {Wang, Mengzhen and Jiang, Yi and Liu, Yinrui and Qian, Wenbin and Lyu, Xiaorui and Zhang, Liming},
+  year = {2020},
+  month = dec,
+  journal = {arXiv},
+  eprint = {2012.03699},
+  eprinttype = {arxiv},
+  url = {http://arxiv.org/abs/2012.03699},
+  archiveprefix = {arXiv}
+}
+
 

docs/conf.py

@@ -208,8 +208,8 @@ def get_minor_version(package_name: str) -> str:
         f"https://ipython.readthedocs.io/en/{get_version('IPython')}",
         None,
     ),
+    "ampform": ("https://ampform--245.org.readthedocs.build/en/245", None),
     "attrs": (f"https://www.attrs.org/en/{get_version('attrs')}", None),
-    "ampform": ("https://ampform.readthedocs.io/en/stable", None),
     "expertsystem": ("https://expertsystem.readthedocs.io/en/stable", None),
     "graphviz": ("https://graphviz.readthedocs.io/en/stable", None),
     "ipywidgets": (
@@ -251,6 +251,7 @@ def get_minor_version(package_name: str) -> str:
 linkcheck_anchors = False
 linkcheck_ignore = [
     "http://127.0.0.1:8000",
+    "https://open.vscode.dev",
 ]
 
 # Settings for myst_nb