diff --git a/R/binary_bbrier.R b/R/binary_bbrier.R
index 024be50..169c6c3 100644
--- a/R/binary_bbrier.R
+++ b/R/binary_bbrier.R
@@ -2,14 +2,12 @@
 #'
 #' @details
 #' The Binary Brier Score is defined as \deqn{
-#'    \frac{1}{n} \sum_{i=1}^n w_i (I_i - p_i)^2.
+#'    \frac{1}{n} \sum_{i=1}^n w_i (I_i - p_i)^2,
 #' }{
-#'    weighted.mean(((t == positive) - p)^2, w).
-#' }
-#' \if{latex}{
-#' \eqn{w_i} are the sample weights,
-#' \eqn{I_{i}}{I_i} is 1 if observation \eqn{i} belongs to the positive class, and 0 otherwise.
+#'    weighted.mean(((t == positive) - p)^2, w),
 #' }
+#' where \eqn{w_i} are the sample weights,
+#'  and \eqn{I_{i}} is 1 if observation \eqn{x_i} belongs to the positive class, and 0 otherwise.
 #'
 #' Note that this (more common) definition of the Brier score is equivalent to the
 #' original definition of the multi-class Brier score (see [mbrier()]) divided by 2.
diff --git a/R/binary_fn.R b/R/binary_fn.R
index 567ae12..6da6c45 100644
--- a/R/binary_fn.R
+++ b/R/binary_fn.R
@@ -3,7 +3,7 @@
 #' @details
 #' This measure counts the false negatives (type 2 error), i.e. the number of
 #' predictions indicating a negative class label while in fact it is positive.
-#' This is sometimes also called a "false alarm".
+#' This is sometimes also called a "miss" or an "underestimation".
 #'
 #' @templateVar mid fn
 #' @template binary_template
diff --git a/R/binary_fp.R b/R/binary_fp.R
index 610aa85..1b8383e 100644
--- a/R/binary_fp.R
+++ b/R/binary_fp.R
@@ -3,6 +3,7 @@
 #' @details
 #' This measure counts the false positives (type 1 error), i.e. the number of
 #' predictions indicating a positive class label while in fact it is negative.
+#' This is sometimes also called a "false alarm".
 #'
 #' @templateVar mid fp
 #' @template binary_template
diff --git a/R/binary_gmean.R b/R/binary_gmean.R
index 35b16cf..3396d54 100644
--- a/R/binary_gmean.R
+++ b/R/binary_gmean.R
@@ -2,7 +2,7 @@
 #'
 #' @details
 #' Calculates the geometric mean of [recall()] R and [specificity()] S as \deqn{
-#'    \sqrt{\mathrm{R} \mathrm{S}}.
+#'    \sqrt{\mathrm{R} \cdot \mathrm{S}}.
 #' }{
 #'    sqrt(R * S)
 #' }
diff --git a/R/binary_gpr.R b/R/binary_gpr.R
index 89dbd2f..79f85d1 100644
--- a/R/binary_gpr.R
+++ b/R/binary_gpr.R
@@ -2,7 +2,7 @@
 #'
 #' @details
 #' Calculates the geometric mean of [precision()] P and [recall()] R as \deqn{
-#'    \sqrt{\mathrm{P} \mathrm{R}}.
+#'    \sqrt{\mathrm{P} \cdot \mathrm{R}}.
 #' }{
 #'    sqrt(P * R)
 #' }
diff --git a/R/binary_prauc.R b/R/binary_prauc.R
index 8d526db..52325e7 100644
--- a/R/binary_prauc.R
+++ b/R/binary_prauc.R
@@ -4,7 +4,7 @@
 #' Computes the area under the Precision-Recall curve (PRC).
 #' The PRC can be interpreted as the relationship between precision and recall (sensitivity),
 #' and is considered to be a more appropriate measure for unbalanced datasets than the ROC curve.
-#' The PRC is computed by integration of the piecewise function.
+#' The AUC-PRC is computed by integration of the piecewise function.
 #'
 #' @templateVar mid prauc
 #' @template binary_template
diff --git a/R/binary_tn.R b/R/binary_tn.R
index 11b9992..8f1cea6 100644
--- a/R/binary_tn.R
+++ b/R/binary_tn.R
@@ -2,7 +2,7 @@
 #'
 #' @details
 #' This measure counts the true negatives, i.e. the number of
-#' predictions correctly indicating a negative class label.
+#' predictions correctly indicating a negative class label. This is sometimes also called a "correct rejection".
 #'
 #' @templateVar mid tn
 #' @template binary_template
diff --git a/R/binary_tnr.R b/R/binary_tnr.R
index ced9ad0..9b6df9b 100644
--- a/R/binary_tnr.R
+++ b/R/binary_tnr.R
@@ -6,7 +6,7 @@
 #' }{
 #'    TN / (FP + TN).
 #' }
-#' Also know as "specificity".
+#' Also know as "specificity" or "selectivity".
 #'
 #' @templateVar mid tnr
 #' @template binary_template
diff --git a/R/binary_tp.R b/R/binary_tp.R
index 93f9136..37f82c3 100644
--- a/R/binary_tp.R
+++ b/R/binary_tp.R
@@ -2,7 +2,7 @@
 #'
 #' @details
 #' This measure counts the true positives, i.e. the number of
-#' predictions correctly indicating a positive class label.
+#' predictions correctly indicating a positive class label. This is sometimes also called a "hit".
 #'
 #' @templateVar mid tp
 #' @template binary_template
diff --git a/R/binary_tpr.R b/R/binary_tpr.R
index 4f8dd79..5988816 100644
--- a/R/binary_tpr.R
+++ b/R/binary_tpr.R
@@ -6,7 +6,7 @@
 #' }{
 #'   TP / (TP + FN).
 #' }
-#' Also know as "recall" or "sensitivity".
+#' This is also know as "recall", "sensitivity", or "probability of detection".
 #'
 #' @details
 #' This measure is undefined if TP + FN = 0.
diff --git a/R/classif_acc.R b/R/classif_acc.R
index 22d95c8..9d6e3ba 100644
--- a/R/classif_acc.R
+++ b/R/classif_acc.R
@@ -1,11 +1,11 @@
 #' @title Classification Accuracy
 #'
 #' @details
-#' The Classification Accuracy is defined as \deqn{
-#'   \frac{1}{n} \sum_{i=1}^n w_i \left( t_i = r_i \right).
-#' }{
-#'   weighted.mean(t == r, w).
-#' }
+#' The Classification Accuracy is defined as
+#'  \deqn{
+#'   \frac{1}{n} \sum_{i=1}^n w_i \mathbf{1} \left( t_i = r_i \right),
+#' }{1 / n * sum(wi * 1(ti = ri))}
+#' where \eqn{w_i} are normalized weights for all observations \eqn{x_i}.
 #'
 #' @templateVar mid acc
 #' @template classif_template
diff --git a/R/classif_bacc.R b/R/classif_bacc.R
index d2045ff..6596716 100644
--- a/R/classif_bacc.R
+++ b/R/classif_bacc.R
@@ -4,18 +4,19 @@
 #' The Balanced Accuracy computes the weighted balanced accuracy, suitable for imbalanced data sets.
 #' It is defined analogously to the definition in [sklearn](https://scikit-learn.org/).
 #'
-#' First, the sample weights \eqn{w} are normalized per class:
+#' First, all sample weights \eqn{w_i} are normalized per class so that each class has the same influence:
 #' \deqn{
-#'  \hat{w}_i = \frac{w_i}{\sum_j 1(y_j = y_i) w_i}.
+#'  \hat{w}_i = \frac{w_i}{\sum_{j=1}^n w_j \cdot \mathbf{1}(t_j = t_i)}.
 #' }{
 #'  w_hat[i] = w[i] / sum((t == t[i]) * w[i]).
 #' }
-#' The balanced accuracy is calculated as
+#' The Balanced Accuracy is then calculated as
 #' \deqn{
-#'  \frac{1}{\sum_i \hat{w}_i} \sum_i 1(r_i = t_i) \hat{w}_i.
+#'  \frac{1}{\sum_{i=1}^n \hat{w}_i} \sum_{i=1}^n \hat{w}_i \cdot \mathbf{1}(r_i = t_i).
 #' }{
 #'  1 / sum(w_hat) * sum((r == t) * w_hat).
 #' }
+#' This definition is equivalent to [acc()] with class-balanced sample weights.
 #'
 #' @references
 #' `r format_bib("brodersen_2010", "guyon_2015")`
diff --git a/R/classif_ce.R b/R/classif_ce.R
index c464375..9b74ee5 100644
--- a/R/classif_ce.R
+++ b/R/classif_ce.R
@@ -2,10 +2,11 @@
 #'
 #' @details
 #' The Classification Error is defined as \deqn{
-#'   \frac{1}{n} \sum_{i=1}^n w_i \left( t_i \neq r_i \right).
+#'   \frac{1}{n} \sum_{i=1}^n w_i \mathbf{1} \left( t_i \neq r_i \right),
 #' }{
-#'   weighted.mean(t != r, w).
+#'   1 / n * sum(wi * 1(ti != ri)),
 #' }
+#' where \eqn{w_i} are normalized weights for each observation \eqn{x_i}.
 #'
 #' @templateVar mid ce
 #' @template classif_template
diff --git a/R/classif_logloss.R b/R/classif_logloss.R
index b776dfa..b934c0e 100644
--- a/R/classif_logloss.R
+++ b/R/classif_logloss.R
@@ -1,12 +1,13 @@
 #' @title Log Loss
 #'
 #' @details
-#' The Log Loss is defined as \deqn{
+#' The Log Loss (a.k.a Benoulli Loss, Logistic Loss, Cross-Entropy Loss) is defined as
+#' \deqn{
 #'   -\frac{1}{n} \sum_{i=1}^n w_i \log \left(  p_i \right )
 #' }{
 #'   -weighted.mean(log(p), w)
 #' }
-#' where \eqn{p_i}{p} is the probability for the true class of observation \eqn{i}.
+#' where \eqn{p_i}{p} is the probability for the true class of observation \eqn{i} and \eqn{w_i} are normalized weights for each observation \eqn{x_i}.
 #'
 #' @templateVar mid logloss
 #' @template classif_template
diff --git a/R/classif_mbrier.R b/R/classif_mbrier.R
index fc3afa4..d68ee0a 100644
--- a/R/classif_mbrier.R
+++ b/R/classif_mbrier.R
@@ -1,12 +1,13 @@
 #' @title Multiclass Brier Score
 #'
 #' @details
-#' Brier score for multi-class classification problems with \eqn{r} labels defined as \deqn{
-#'    \frac{1}{n} \sum_{i=1}^n \sum_{j=1}^r (I_{ij} - p_{ij})^2.
+#' Brier score for multi-class classification problems with \eqn{k} labels defined as \deqn{
+#'    \frac{1}{n} \sum_{i=1}^n \sum_{j=1}^k (I_{ij} - p_{ij})^2.
 #' }{
 #     1/n * sum_i sum_j (I_ij - p_ij)^2.
 #' }
-#' \eqn{I_{ij}}{I_ij} is 1 if observation \eqn{i} has true label \eqn{j}, and 0 otherwise.
+#' \eqn{I_{ij}}{I_ij} is 1 if observation \eqn{x_i} has true label \eqn{j}, and 0 otherwise.
+#' \eqn{p_{ij}{p_ij} is the probability that observation \eqn{x_i} belongs to class \eqn{j}.
 #'
 #' Note that there also is the more common definition of the Brier score for binary
 #' classification problems in [bbrier()].
diff --git a/R/classif_mcc.R b/R/classif_mcc.R
index 83a30f3..8ccf6bf 100644
--- a/R/classif_mcc.R
+++ b/R/classif_mcc.R
@@ -8,7 +8,7 @@
 #' }
 #' where \eqn{TP}, \eqn{FP}, \eqn{TN}, \eqn{TP} are the number of true positives, false positives, true negatives, and false negatives respectively.
 #'
-#' In the multi-class case, the Matthews Correlation Coefficient defined for a multi-class confusion matrix \eqn{C} with \eqn{K} classes: \deqn{
+#' In the multi-class case, the Matthews Correlation Coefficient is defined for a multi-class confusion matrix \eqn{C} with \eqn{K} classes: \deqn{
 #'    \frac{c \cdot s - \sum_k^K p_k \cdot t_k}{\sqrt{(s^2 - \sum_k^K p_k^2) \cdot (s^2 - \sum_k^K t_k^2)}},
 #' }{
 #'    (c * s - sum(pk * tk)) / sqrt((s^2 - sum(pk^2)) * (s^2 - sum(tk^2))),
@@ -23,8 +23,9 @@
 #' @template classif_template
 #'
 #' @details
-#' The above formula is undefined if any of the four sums in the denominator is 0 in the binary case and more generally if either \eqn{s^2 - sum(pk^2)} or \eqn{s^2 - sum(tk^2)} is equal to 0.
+#' The above formula is undefined if any of the four sums in the denominator is 0 in the binary case and more generally if either \eqn{s^2 - \sum_k^K p_k^2} or \eqn{s^2 - \sum_k^K t_k^2)} is equal to 0.
 #' The denominator is then set to 1.
+#'
 #' When there are more than two classes, the MCC will no longer range between -1 and +1.
 #' Instead, the minimum value will be between -1 and 0 depending on the true distribution. The maximum value is always +1.
 #'
diff --git a/R/classif_zero_one.R b/R/classif_zero_one.R
index 16d05f7..9d2427f 100644
--- a/R/classif_zero_one.R
+++ b/R/classif_zero_one.R
@@ -1,12 +1,16 @@
 #' @title Zero-One Classification Loss (per observation)
 #'
 #' @description
-#' Calculates the per-observation 0/1 loss as \deqn{
-#'   t_i \neq r_1.
+#' Calculates the per-observation 0/1 (zero-one) loss as \deqn{
+#'   \mathbf{1} (t_i \neq r_1).
 #' }{
-#'   t != r.
+#'   1(t != r).
+#' }
+#' The 1/0 (one-zero) loss is equal to 1 - zero-one and calculated as \deqn{
+#'   \mathbf{1} (t_i = r_i).
+#' }{
+#'   1(t_i = r_i).
 #' }
-#' The one-zero loss is 1 - zero-one.
 #'
 #' @templateVar mid zero_one
 #' @template classif_template
diff --git a/R/confusion_matrix.R b/R/confusion_matrix.R
index 85168f6..e31f509 100644
--- a/R/confusion_matrix.R
+++ b/R/confusion_matrix.R
@@ -2,7 +2,18 @@
 #'
 #' @description
 #' Calculates the confusion matrix for a binary classification problem
-#' once and then calculates all confusion measures of this package.
+#' once and then calculates all binary confusion measures of this package.
+#'
+#' @details
+#' The binary confusion matrix is defined as \deqn{
+#' \begin{pmatrix}
+#' TP & FP \\
+#' FN & TN
+#' \end{pmatrix}.
+#' }{
+#' matrix(TP, FP, FN, TN).
+#' }
+#' If `relative = TRUE`, all values are divided by \eqn{n}.
 #'
 #' @inheritParams binary_params
 #' @param relative (`logical(1)`)\cr
diff --git a/R/regr_ae.R b/R/regr_ae.R
index 3ceb1b7..78513fc 100644
--- a/R/regr_ae.R
+++ b/R/regr_ae.R
@@ -1,6 +1,6 @@
 #' @title Absolute Error (per observation)
 #'
-#' @description
+#' @details
 #' Calculates the per-observation absolute error as \deqn{
 #'   \left| t_i - r_i \right|.
 #' }{
diff --git a/R/regr_ape.R b/R/regr_ape.R
index 40ab4a5..30b73d0 100644
--- a/R/regr_ape.R
+++ b/R/regr_ape.R
@@ -1,6 +1,6 @@
 #' @title Absolute Percentage Error (per observation)
 #'
-#' @description
+#' @details
 #' Calculates the per-observation absolute percentage error as \deqn{
 #'   \left| \frac{ t_i - r_i}{t_i} \right|.
 #' }{
diff --git a/R/regr_bias.R b/R/regr_bias.R
index 11312d3..ad83f91 100644
--- a/R/regr_bias.R
+++ b/R/regr_bias.R
@@ -2,10 +2,11 @@
 #'
 #' @details
 #' The Bias is defined as \deqn{
-#'   \frac{1}{n} \sum_{i=1}^n w_i \left( t_i - r_i \right).
+#'   \frac{1}{n} \sum_{i=1}^n w_i \left( t_i - r_i \right),
 #' }{
-#'   weighted.mean(t - r, w).
+#'   weighted.mean(t - r, w),
 #' }
+#' where \eqn{w_i} are normalized sample weights.
 #' Good predictions score close to 0.
 #'
 #' @templateVar mid bias
diff --git a/R/regr_ktau.R b/R/regr_ktau.R
index eb870ce..c7dfc25 100644
--- a/R/regr_ktau.R
+++ b/R/regr_ktau.R
@@ -2,6 +2,10 @@
 #'
 #' @details
 #' Kendall's tau is defined as Kendall's rank correlation coefficient between truth and response.
+#' It is defined as \deqn{
+#'   \tau = \frac{(\mathrm{number of concordant pairs)} - (\mathrm{number of discordant pairs)}}{\mathrm{(number of pairs)}}
+#'   }{
+#'     t = (number of concordant pairs) - (number of discordant pairs) / (number of pairs)}
 #' Calls [stats::cor()] with `method` set to `"kendall"`.
 #'
 #' @templateVar mid ktau
diff --git a/R/regr_mae.R b/R/regr_mae.R
index 953b246..4472950 100644
--- a/R/regr_mae.R
+++ b/R/regr_mae.R
@@ -2,10 +2,11 @@
 #'
 #' @details
 #' The Mean Absolute Error is defined as \deqn{
-#'   \frac{1}{n} \sum_{i=1}^n w_i \left| t_i - r_i \right|.
+#'   \frac{1}{n} \sum_{i=1}^n w_i \left| t_i - r_i \right|,
 #' }{
-#'   weighted.mean(abs(t - r), w).
+#'   weighted.mean(abs(t - r), w),
 #' }
+#' where \eqn{w_i} are normalized sample weights.
 #'
 #' @templateVar mid mae
 #' @template regr_template
diff --git a/R/regr_mape.R b/R/regr_mape.R
index 832fc74..1c09ca8 100644
--- a/R/regr_mape.R
+++ b/R/regr_mape.R
@@ -2,10 +2,11 @@
 #'
 #' @details
 #' The Mean Absolute Percent Error is defined as \deqn{
-#'   \frac{1}{n} \sum_{i=1}^n w_i \left| \frac{ t_i - r_i}{t_i} \right|.
+#'   \frac{1}{n} \sum_{i=1}^n w_i \left| \frac{ t_i - r_i}{t_i} \right|,
 #'  }{
-#'    weighted.mean(abs((t - r) / t), w).
+#'    weighted.mean(abs((t - r) / t), w),
 #'  }
+#' where \eqn{w_i} are normalized sample weights.
 #'
 #' @details
 #' This measure is undefined if any element of \eqn{t} is \eqn{0}.
diff --git a/R/regr_medae.R b/R/regr_medae.R
index 5050525..74fc8ee 100644
--- a/R/regr_medae.R
+++ b/R/regr_medae.R
@@ -2,7 +2,7 @@
 #'
 #' @details
 #' The Median Absolute Error is defined as \deqn{
-#'   \mathop{\mathrm{median}}_i \left| t_i - r_i \right|.
+#'   \mathop{\mathrm{median}} \left| t_i - r_i \right|.
 #' }{
 #'   median(abs(t - r)).
 #' }
diff --git a/R/regr_medse.R b/R/regr_medse.R
index ad5cb01..645a1d8 100644
--- a/R/regr_medse.R
+++ b/R/regr_medse.R
@@ -2,7 +2,7 @@
 #'
 #' @details
 #' The Median Squared Error is defined as \deqn{
-#'   \mathop{\mathrm{median}}_i \left[ \left( t_i - r_i \right)^2 \right].
+#'   \mathop{\mathrm{median}} \left[ \left( t_i - r_i \right)^2 \right].
 #' }{
 #'   median((t - r)^2).
 #' }
diff --git a/R/regr_mse.R b/R/regr_mse.R
index 464a82b..86c7629 100644
--- a/R/regr_mse.R
+++ b/R/regr_mse.R
@@ -2,10 +2,11 @@
 #'
 #' @details
 #' The Mean Squared Error is defined as \deqn{
-#'   \frac{1}{n} w_i \sum_{i=1}^n \left( t_i - r_i \right)^2.
+#'   \frac{1}{n} \sum_{i=1}^n w_i \left( t_i - r_i \right)^2,
 #' }{
-#'   weighted.mean((t - r)^2, w).
+#'   weighted.mean((t - r)^2, w),
 #' }
+#' where \eqn{w_i} are normalized sample weights.
 #'
 #' @templateVar mid mse
 #' @template regr_template
diff --git a/R/regr_msle.R b/R/regr_msle.R
index 160e605..2e819c7 100644
--- a/R/regr_msle.R
+++ b/R/regr_msle.R
@@ -2,17 +2,16 @@
 #'
 #' @details
 #' The Mean Squared Log Error is defined as \deqn{
-#'   \frac{1}{n} \sum_{i=1}^n w_i \left( \ln (1 + t_i) - \ln (1 + r_i) \right)^2.
+#'   \frac{1}{n} \sum_{i=1}^n w_i \left( \ln (1 + t_i) - \ln (1 + r_i) \right)^2,
 #' }{
-#'   weighted.mean((log(1 + t) - log(1 + r))^2, weights).
+#'   weighted.mean((log(1 + t) - log(1 + r))^2, weights),
 #' }
+#' where \eqn{w_i} are normalized sample weights.
+#' This measure is undefined if any element of \eqn{t} or \eqn{r} is less than or equal to \eqn{-1}.
 #'
 #' @templateVar mid msle
 #' @template regr_template
 #'
-#' @details
-#' This measure is undefined if any element of \eqn{t} or \eqn{r} is less than or equal to \eqn{-1}.
-#'
 #' @inheritParams regr_params
 #' @template regr_example
 #' @export
diff --git a/R/regr_pbias.R b/R/regr_pbias.R
index 1935432..4aee2e4 100644
--- a/R/regr_pbias.R
+++ b/R/regr_pbias.R
@@ -2,10 +2,11 @@
 #'
 #' @details
 #' The Percent Bias is defined as \deqn{
-#'   \frac{1}{n} \sum_{i=1}^n w_i \frac{\left( t_i - r_i \right)}{\left| t_i \right|}.
+#'   \frac{1}{n} \sum_{i=1}^n w_i \frac{\left( t_i - r_i \right)}{\left| t_i \right|},
 #' }{
-#'   weighted.mean((t - r) / abs(t), w).
+#'   weighted.mean((t - r) / abs(t), w),
 #' }
+#' where \eqn{w_i} are normalized sample weights.
 #' Good predictions score close to 0.
 #'
 #' @templateVar mid pbias
diff --git a/R/regr_rae.R b/R/regr_rae.R
index 7982029..079857a 100644
--- a/R/regr_rae.R
+++ b/R/regr_rae.R
@@ -2,18 +2,18 @@
 #'
 #' @details
 #' The Relative Absolute Error is defined as \deqn{
-#'   \frac{\sum_{i=1}^n \left| t_i - r_i \right|}{\sum_{i=1}^n \left| t_i - \bar{t} \right|}.
+#'   \frac{\sum_{i=1}^n \left| t_i - r_i \right|}{\sum_{i=1}^n \left| t_i - \bar{t} \right|},
 #' }{
-#'   sum((t - r)^2) / sum((t - mean(t))^2).
+#'   sum((t - r)^2) / sum((t - mean(t))^2),
 #' }
+#' where \eqn{\bar{t} = \sum_{i=1}^n t_i}.
+#' This measure is undefined for constant \eqn{t}.
+#'
 #' Can be interpreted as absolute error of the predictions relative to a naive model predicting the mean.
 #'
 #' @templateVar mid rae
 #' @template regr_template
 #'
-#' @details
-#' This measure is undefined for constant \eqn{t}.
-#'
 #' @inheritParams regr_params
 #' @template regr_example
 #' @export
diff --git a/R/regr_rmse.R b/R/regr_rmse.R
index 7abbee8..9d9893f 100644
--- a/R/regr_rmse.R
+++ b/R/regr_rmse.R
@@ -2,10 +2,11 @@
 #'
 #' @details
 #' The Root Mean Squared Error is defined as \deqn{
-#'   \sqrt{\frac{1}{n} \sum_{i=1}^n w_i \left( t_i - r_i \right)^2}.
+#'   \sqrt{\frac{1}{n} \sum_{i=1}^n w_i \left( t_i - r_i \right)^2},
 #' }{
-#'   sqrt(weighted.mean((t - r)^2, w)).
+#'   sqrt(weighted.mean((t - r)^2, w)),
 #' }
+#' where \eqn{w_i} are normalized sample weights.
 #'
 #' @templateVar mid rmse
 #' @template regr_template
diff --git a/R/regr_rmsle.R b/R/regr_rmsle.R
index 740909a..b049ad2 100644
--- a/R/regr_rmsle.R
+++ b/R/regr_rmsle.R
@@ -2,17 +2,17 @@
 #'
 #' @details
 #' The Root Mean Squared Log Error is defined as \deqn{
-#'   \sqrt{\frac{1}{n} \sum_{i=1}^n w_i \left( \ln (1 + t_i) - \ln (1 + r_i) \right)^2}.
+#'   \sqrt{\frac{1}{n} \sum_{i=1}^n w_i \left( \ln (1 + t_i) - \ln (1 + r_i) \right)^2},
 #' }{
-#'   sqrt(weighted.mean((log(1 + t) - log(1 + r))^2, w)).
+#'   sqrt(weighted.mean((log(1 + t) - log(1 + r))^2, w)),
 #' }
+#' where \eqn{w_i} are normalized sample weights.
+#'
+#' This measure is undefined if any element of \eqn{t} or \eqn{r} is less than or equal to \eqn{-1}.
 #'
 #' @templateVar mid rmsle
 #' @template regr_template
 #'
-#' @details
-#' This measure is undefined if any element of \eqn{t} or \eqn{r} is less than or equal to \eqn{-1}.
-#'
 #' @inheritParams regr_params
 #' @template regr_example
 #' @export
diff --git a/R/regr_rrse.R b/R/regr_rrse.R
index 1a0c979..e13276d 100644
--- a/R/regr_rrse.R
+++ b/R/regr_rrse.R
@@ -2,18 +2,19 @@
 #'
 #' @details
 #' The Root Relative Squared Error is defined as \deqn{
-#'   \sqrt{\frac{\sum_{i=1}^n \left( t_i - r_i \right)^2}{\sum_{i=1}^n \left( t_i - \bar{t} \right)^2}}.
+#'   \sqrt{\frac{\sum_{i=1}^n \left( t_i - r_i \right)^2}{\sum_{i=1}^n \left( t_i - \bar{t} \right)^2}},
 #' }{
-#'   sqrt(sum((t - r)^2) / sum((t - mean(t))^2)).
+#'   sqrt(sum((t - r)^2) / sum((t - mean(t))^2)),
 #' }
+#' where \eqn{\bar{t} = \sum_{i=1}^n t_i}.
+#'
 #' Can be interpreted as root of the squared error of the predictions relative to a naive model predicting the mean.
 #'
+#' This measure is undefined for constant \eqn{t}.
+#'
 #' @templateVar mid rrse
 #' @template regr_template
 #'
-#' @details
-#' This measure is undefined for constant \eqn{t}.
-#'
 #' @inheritParams regr_params
 #' @template regr_example
 #' @export
diff --git a/R/regr_rse.R b/R/regr_rse.R
index ec4f3b9..08f0bf1 100644
--- a/R/regr_rse.R
+++ b/R/regr_rse.R
@@ -2,18 +2,19 @@
 #'
 #' @details
 #' The Relative Squared Error is defined as \deqn{
-#'   \frac{\sum_{i=1}^n \left( t_i - r_i \right)^2}{\sum_{i=1}^n \left( t_i - \bar{t} \right)^2}.
+#'   \frac{\sum_{i=1}^n \left( t_i - r_i \right)^2}{\sum_{i=1}^n \left( t_i - \bar{t} \right)^2},
 #' }{
-#'   sum((t - r)^2) / sum((t - mean(t))^2).
+#'   sum((t - r)^2) / sum((t - mean(t))^2),
 #' }
+#' where \eqn{\bar{t} = \sum_{i=1}^n t_i}.
+#'
 #' Can be interpreted as squared error of the predictions relative to a naive model predicting the mean.
 #'
+#' This measure is undefined for constant \eqn{t}.
+#'
 #' @templateVar mid rse
 #' @template regr_template
 #'
-#' @details
-#' This measure is undefined for constant \eqn{t}.
-#'
 #' @inheritParams regr_params
 #' @template regr_example
 #' @export
diff --git a/R/regr_rsq.R b/R/regr_rsq.R
index e8b8d9c..02ec269 100644
--- a/R/regr_rsq.R
+++ b/R/regr_rsq.R
@@ -2,21 +2,21 @@
 #'
 #' @details
 #' R Squared is defined as \deqn{
-#'   1 - \frac{\sum_{i=1}^n \left( t_i - r_i \right)^2}{\sum_{i=1}^n \left( t_i - \bar{t} \right)^2}.
+#'   1 - \frac{\sum_{i=1}^n \left( t_i - r_i \right)^2}{\sum_{i=1}^n \left( t_i - \bar{t} \right)^2},
 #' }{
-#'   1 - sum((t - r)^2) / sum((t - mean(t))^2).
+#'   1 - sum((t - r)^2) / sum((t - mean(t))^2),
 #' }
+#' where \eqn{\bar{t} = \sum_{i=1}^n t_i}.
+#'
 #' Also known as coefficient of determination or explained variation.
 #' Subtracts the [rse()] from 1, hence it compares the squared error of
 #' the predictions relative to a naive model predicting the mean.
 #'
+#' This measure is undefined for constant \eqn{t}.
 #'
 #' @templateVar mid rsq
 #' @template regr_template
 #'
-#' @details
-#' This measure is undefined for constant \eqn{t}.
-#'
 #' @inheritParams regr_params
 #' @template regr_example
 #' @export
diff --git a/R/regr_se.R b/R/regr_se.R
index cee587e..395c3a4 100644
--- a/R/regr_se.R
+++ b/R/regr_se.R
@@ -1,6 +1,6 @@
 #' @title Squared Error (per observation)
 #'
-#' @description
+#' @details
 #' Calculates the per-observation squared error as \deqn{
 #'   \left( t_i - r_i \right)^2.
 #' }{
diff --git a/R/regr_smape.R b/R/regr_smape.R
index 42abb06..429a9ef 100644
--- a/R/regr_smape.R
+++ b/R/regr_smape.R
@@ -7,12 +7,11 @@
 #'   2 * mean(abs(t - r) / (abs(t) + abs(r))).
 #' }
 #'
+#' This measure is undefined if if any \eqn{|t| + |r|} is equal to \eqn{0}.
+#'
 #' @templateVar mid smape
 #' @template regr_template
 #'
-#' @details
-#' This measure is undefined if if any \eqn{|t| + |r|} is \eqn{0}.
-#'
 #' @inheritParams regr_params
 #' @template regr_example
 #' @export