diff --git a/docs/about.md b/docs/about.md index af05ec78..f3204535 100644 --- a/docs/about.md +++ b/docs/about.md @@ -33,13 +33,29 @@ Finally, the {doc}`technical reports ` on these pages tips and tricks, some of which can be of interest to general Python users as well! +:::{dropdown} Deprecated projects + +The main packages listed above originate from the following, deprecated +projects: + + + +- {doc}`ComPWA `: a single framework for Partial Wave Analysis + written in C++. +- {doc}`pycompwa `: the Python interface of ComPWA, which also + hosted a first version of the PWA Expert System. +- {doc}`PWA Expert System ` (split into + {doc}`QRules ` and {doc}`AmpForm `). + +::: + ## Long-term development Partial Wave Analysis is a complicated research discipline, where several aspects of quantum field theory, experimental physics, statistics, regression analysis, and high-performance computing come together. This has led to -{ref}`a large number of PWA frameworks ` that -taylor to the need of each collaboration. +{ref}`a large number of PWA frameworks ` +that taylor to the need of each collaboration. This state of affairs is only natural: research requires a flexible and specialized approach. If, say, some background component shows up in an ongoing diff --git a/docs/develop.md b/docs/develop.md index 6480e8f8..73fcf86b 100644 --- a/docs/develop.md +++ b/docs/develop.md @@ -64,8 +64,8 @@ administrator rights, see instructions on [this page](https://www.anaconda.com/distribution). In addition, Conda can install more than just Python packages. -All projects -{ref}`affiliated with the PWA pages ` provide a +All packages {ref}`maintained by the ComPWA organization ` +provide a [Conda environment file](https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html) ([`environment.yml`](https://github.com/ComPWA/ampform/blob/main/environment.yml)) that defines the minimal dependencies to run the framework. To create an @@ -607,10 +607,10 @@ Publicly available are: ### Branching model While our aim is to maintain long-term, stable projects, -{ref}`PWA software projects ` are academic -projects that are subject to change and often require swift modifications or -new features for ongoing analyses. For this reason, we work in different layers -of development. These layers are represented by Git branches. +{ref}`PWA software projects ` are +academic projects that are subject to change and often require swift +modifications or new features for ongoing analyses. For this reason, we work in +different layers of development. These layers are represented by Git branches. ![Epic branches](./_static/epic-branches.svg)