add references + info about HDI+ROPE criteria

Author: drbenvincent

examples/howto/hdi_plus_rope_decision_rule.png

@@ -509,6 +509,18 @@
     "This shows that there is only a 2.6% chance that the mean is within the chosen ROPE."
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "de465219",
+   "metadata": {},
+   "source": [
+    "{ref}`kruschke2018rejecting` outlines the HDI+ROPE decision rule, which is summarised in the figure taken from that paper:\n",
+    "\n",
+    "![](hdi_plus_rope_decision_rule.png)\n",
+    "\n",
+    "In our case, we would remain undecided because the HDI does not fall entirely outside nor within the ROPE."
+   ]
+  },
   {
    "cell_type": "markdown",
    "id": "0524af06",
@@ -583,6 +595,17 @@
     "* Authored by [Benjamin T. Vincent](https://github.com/drbenvincent) in December, 2024."
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "2b3bbd1b",
+   "metadata": {},
+   "source": [
+    "## References\n",
+    ":::{bibliography}\n",
+    ":filter: docname in docnames\n",
+    ":::"
+   ]
+  },
   {
    "cell_type": "markdown",
    "id": "1aec5c13",

examples/howto/hypothesis_testing.ipynb

@@ -169,6 +169,14 @@ This shows that there is only a 2.6% chance that the mean is within the chosen R
 
 +++
 
+{ref}`kruschke2018rejecting` outlines the HDI+ROPE decision rule, which is summarised in the figure taken from that paper:
+
+![](hdi_plus_rope_decision_rule.png)
+
+In our case, we would remain undecided because the HDI does not fall entirely outside nor within the ROPE.
+
++++
+
 ### Bayes Factors
 
 Bayes Factors provide a Bayesian alternative to classical hypothesis tests, allowing you to weigh evidence for one hypothesis relative to another. In the simplest case—testing whether $\mu=0$ versus $\mu \neq 0$ — the Bayes Factor (BF) tells you how much more (or less) likely your observed data are under the model where $\mu=0$ than under the model where $\mu$ is free to vary.
@@ -199,6 +207,13 @@ We can see that the probability of $\mu=0$ has gone _down_ after observing the d
 
 +++
 
+## References
+:::{bibliography}
+:filter: docname in docnames
+:::
+
++++
+
 ## Watermark
 
 ```{code-cell} ipython3

examples/howto/hypothesis_testing.myst.md

@@ -937,3 +937,23 @@ @article{Yao_2022
 doi = {10.1214/21-BA1287},
 URL = {https://doi.org/10.1214/21-BA1287}
 }
+@article{kruschke2010believe,
+  title={What to believe: Bayesian methods for data analysis},
+  author={Kruschke, John K},
+  journal={Trends in cognitive sciences},
+  volume={14},
+  number={7},
+  pages={293--300},
+  year={2010},
+  publisher={Elsevier}
+}
+@article{kruschke2018rejecting,
+  title={Rejecting or accepting parameter values in Bayesian estimation},
+  author={Kruschke, John K},
+  journal={Advances in methods and practices in psychological science},
+  volume={1},
+  number={2},
+  pages={270--280},
+  year={2018},
+  publisher={Sage Publications Sage CA: Los Angeles, CA}
+}