DOC: introduction and generation state (#11)

* first draft of intro * Change of contents and dependency * pgamma virtual state generation! * ready to go draft of decay and gamma generation * draft now for the transition * add transition and graph * test diff transitions * strong EM weak transition * organise transition graph * add STM section --------- Co-authored-by: Remco de Boer <[email protected]>
ComPWA · Jun 12, 2024 · cccd420 · cccd420
1 parent 137fc78
commit cccd420
Show file tree

Hide file tree

Showing 7 changed files with 1,885 additions and 121 deletions.
diff --git a/docs/conf.py b/docs/conf.py
@@ -6,7 +6,14 @@
     "_build",
 ]
 extensions = ["myst_nb"]
-html_theme = "pydata_sphinx_theme"
+html_theme = "sphinx_book_theme"
 master_doc = "index"
+myst_enable_extensions = [
+    "amsmath",
+    "colon_fence",
+    "dollarmath",
+    "html_image",
+    "smartquotes",
+]
 nitpicky = True
 project = "GlueX N-Star"
diff --git a/docs/hello.ipynb b/docs/hello.ipynb
diff --git a/docs/index.md b/docs/index.md
@@ -1,5 +1,20 @@
-# MyST-NB Quickstart
+# Amplitude Analysis 101 / PWA101 (v2.0)
+
+## CAS-assisted Amplitude Models building for photoproduction reaction
+
+This document is a follow-up of PWA101 (v1.0) (temporarily see [here](https://compwa--217.org.readthedocs.build/report/999.html)),
+as an introduction to Amplitude Analysis / Partial Wave Analysis (PWA) by demonstrating its application to a specific reaction channel and amplitude model.
+
+Now the focus is the use of symbolic expressions (computations), with the use of [ComPWA packages](https://compwa.github.io/), or CAS(Computer Algebra System)-assisted model building in general (the python package `SymPy` in this case) to illustrate the general process in PWA.
+
+This tutorial aims to equip readers with deeper understanding of PWA methodologies and full workflow in the context of hadron physics through a practical, hands-on example with symbolic expressions via [ComPWA](https://compwa.github.io/).
+
+Furthermore,
+address to the issue ✅&nbsp;[ComPWA/gluex-nstar#1](https://github.com/ComPWA/gluex-nstar/issues/1), this document is PWA101(v2.0), which shows PWA methodologies and full workflow in the context of hadron physics with symbolic expressions via [ComPWA](https://compwa.github.io/).
+
+# Table of contents:
 
 ```{toctree}
-hello
+reaction
+pgamma-state
 ```