From 589dceb5b38b409dce072a87112327db23a73f34 Mon Sep 17 00:00:00 2001
From: Krishna Vedala <krishna.vedala@ieee.org>
Date: Thu, 28 May 2020 16:34:37 -0400
Subject: [PATCH] document bayes theorem

---
 probability/bayes_theorem.cpp | 26 +++++++++++++++-----------
 1 file changed, 15 insertions(+), 11 deletions(-)

diff --git a/probability/bayes_theorem.cpp b/probability/bayes_theorem.cpp
index d30be6c9a..aaa557a94 100644
--- a/probability/bayes_theorem.cpp
+++ b/probability/bayes_theorem.cpp
@@ -1,24 +1,28 @@
+/**
+ * @file
+ * @brief [Bayes' theorem](https://en.wikipedia.org/wiki/Bayes%27_theorem)
+ *
+ * Bayes' theorem allows one to find \f$P(A|B)\f$ given \f$P(B|A)\f$ or
+ * \f$P(B|A)\f$ given \f$P(A|B)\f$ and \f$P(A)\f$ and \f$P(B)\f$.\n
+ * Note that \f$P(A|B)\f$ is read 'The probability of A given that the event B
+ * has occured'.
+ */
 #include <iostream>
 
-// bayes' theorem > https://en.wikipedia.org/wiki/Bayes%27_theorem
-
-// bayes' theorem allows one to find P(A|B) given P(B|A)
-// or P(B|A) given P(A|B) and P(A) and P(B)
-
-// note P(A|B) is read 'The probability of A given that the event B has occured'
-
-// returns P(A|B)
-
+/** returns P(A|B)
+ */
 double bayes_AgivenB(double BgivenA, double A, double B) {
     return (BgivenA * A) / B;
 }
 
-// returns P(B|A)
-
+/** returns P(B|A)
+ */
 double bayes_BgivenA(double AgivenB, double A, double B) {
     return (AgivenB * B) / A;
 }
 
+/** Main function
+ */
 int main() {
     double A = 0.01;
     double B = 0.1;