docs: use template spq-params

R/create_dist.R

@@ -10,16 +10,12 @@
 #' Returns a stacked bar plot by default.
 #' Additional options available to return a table with distribution elements.
 #'
-#' @param data A Standard Person Query dataset in the form of a data frame.
+#' @template spq-params
 #' @param metric String containing the name of the metric,
 #' e.g. "Collaboration_hours"
-#' @param hrvar HR Variable by which to split metrics. Accepts a character
-#'   vector, defaults to "Organization" but accepts any character vector, e.g.
-#'   "LevelDesignation"
-#' @param mingroup Numeric value setting the privacy threshold / minimum group
-#'   size, defaults to 5.
 #'
-#' @param return String specifying what to return. This must be one of the following strings:
+#' @param return String specifying what to return. This must be one of the
+#'   following strings:
 #'   - `"plot"`
 #'   - `"table"`
 #'

man/afterhours_dist.Rd

@@ -15,14 +15,15 @@ afterhours_dist(
 \arguments{
 \item{data}{A Standard Person Query dataset in the form of a data frame.}
 
-\item{hrvar}{HR Variable by which to split metrics. Accepts a character
+\item{hrvar}{String containing the name of the HR Variable by which to split
-vector, defaults to "Organization" but accepts any character vector, e.g.
+metrics. Defaults to \code{"Organization"}. To run the analysis on the total
-"LevelDesignation"}
+instead of splitting by an HR attribute, supply \code{NULL} (without quotes).}
 
 \item{mingroup}{Numeric value setting the privacy threshold / minimum group
-size, defaults to 5.}
+size. Defaults to 5.}
 
-\item{return}{String specifying what to return. This must be one of the following strings:
+\item{return}{String specifying what to return. This must be one of the
+following strings:
 \itemize{
 \item \code{"plot"}
 \item \code{"table"}

man/collaboration_dist.Rd

@@ -24,14 +24,15 @@ collab_dist(
 \arguments{
 \item{data}{A Standard Person Query dataset in the form of a data frame.}
 
-\item{hrvar}{HR Variable by which to split metrics. Accepts a character
+\item{hrvar}{String containing the name of the HR Variable by which to split
-vector, defaults to "Organization" but accepts any character vector, e.g.
+metrics. Defaults to \code{"Organization"}. To run the analysis on the total
-"LevelDesignation"}
+instead of splitting by an HR attribute, supply \code{NULL} (without quotes).}
 
 \item{mingroup}{Numeric value setting the privacy threshold / minimum group
-size, defaults to 5.}
+size. Defaults to 5.}
 
-\item{return}{String specifying what to return. This must be one of the following strings:
+\item{return}{String specifying what to return. This must be one of the
+following strings:
 \itemize{
 \item \code{"plot"}
 \item \code{"table"}

man/create_dist.Rd

@@ -21,14 +21,15 @@ create_dist(
 \item{metric}{String containing the name of the metric,
 e.g. "Collaboration_hours"}
 
-\item{hrvar}{HR Variable by which to split metrics. Accepts a character
+\item{hrvar}{String containing the name of the HR Variable by which to split
-vector, defaults to "Organization" but accepts any character vector, e.g.
+metrics. Defaults to \code{"Organization"}. To run the analysis on the total
-"LevelDesignation"}
+instead of splitting by an HR attribute, supply \code{NULL} (without quotes).}
 
 \item{mingroup}{Numeric value setting the privacy threshold / minimum group
-size, defaults to 5.}
+size. Defaults to 5.}
 
-\item{return}{String specifying what to return. This must be one of the following strings:
+\item{return}{String specifying what to return. This must be one of the
+following strings:
 \itemize{
 \item \code{"plot"}
 \item \code{"table"}

man/email_dist.Rd

@@ -15,14 +15,15 @@ email_dist(
 \arguments{
 \item{data}{A Standard Person Query dataset in the form of a data frame.}
 
-\item{hrvar}{HR Variable by which to split metrics. Accepts a character
+\item{hrvar}{String containing the name of the HR Variable by which to split
-vector, defaults to "Organization" but accepts any character vector, e.g.
+metrics. Defaults to \code{"Organization"}. To run the analysis on the total
-"LevelDesignation"}
+instead of splitting by an HR attribute, supply \code{NULL} (without quotes).}
 
 \item{mingroup}{Numeric value setting the privacy threshold / minimum group
-size, defaults to 5.}
+size. Defaults to 5.}
 
-\item{return}{String specifying what to return. This must be one of the following strings:
+\item{return}{String specifying what to return. This must be one of the
+following strings:
 \itemize{
 \item \code{"plot"}
 \item \code{"table"}

man/meeting_dist.Rd

@@ -15,14 +15,15 @@ meeting_dist(
 \arguments{
 \item{data}{A Standard Person Query dataset in the form of a data frame.}
 
-\item{hrvar}{HR Variable by which to split metrics. Accepts a character
+\item{hrvar}{String containing the name of the HR Variable by which to split
-vector, defaults to "Organization" but accepts any character vector, e.g.
+metrics. Defaults to \code{"Organization"}. To run the analysis on the total
-"LevelDesignation"}
+instead of splitting by an HR attribute, supply \code{NULL} (without quotes).}
 
 \item{mingroup}{Numeric value setting the privacy threshold / minimum group
-size, defaults to 5.}
+size. Defaults to 5.}
 
-\item{return}{String specifying what to return. This must be one of the following strings:
+\item{return}{String specifying what to return. This must be one of the
+following strings:
 \itemize{
 \item \code{"plot"}
 \item \code{"table"}

man/one2one_dist.Rd

@@ -15,14 +15,15 @@ one2one_dist(
 \arguments{
 \item{data}{A Standard Person Query dataset in the form of a data frame.}
 
-\item{hrvar}{HR Variable by which to split metrics. Accepts a character
+\item{hrvar}{String containing the name of the HR Variable by which to split
-vector, defaults to "Organization" but accepts any character vector, e.g.
+metrics. Defaults to \code{"Organization"}. To run the analysis on the total
-"LevelDesignation"}
+instead of splitting by an HR attribute, supply \code{NULL} (without quotes).}
 
 \item{mingroup}{Numeric value setting the privacy threshold / minimum group
-size, defaults to 5.}
+size. Defaults to 5.}
 
-\item{return}{String specifying what to return. This must be one of the following strings:
+\item{return}{String specifying what to return. This must be one of the
+following strings:
 \itemize{
 \item \code{"plot"}
 \item \code{"table"}

man/workloads_dist.Rd

@@ -15,14 +15,15 @@ workloads_dist(
 \arguments{
 \item{data}{A Standard Person Query dataset in the form of a data frame.}
 
-\item{hrvar}{HR Variable by which to split metrics. Accepts a character
+\item{hrvar}{String containing the name of the HR Variable by which to split
-vector, defaults to "Organization" but accepts any character vector, e.g.
+metrics. Defaults to \code{"Organization"}. To run the analysis on the total
-"LevelDesignation"}
+instead of splitting by an HR attribute, supply \code{NULL} (without quotes).}
 
 \item{mingroup}{Numeric value setting the privacy threshold / minimum group
-size, defaults to 5.}
+size. Defaults to 5.}
 
-\item{return}{String specifying what to return. This must be one of the following strings:
+\item{return}{String specifying what to return. This must be one of the
+following strings:
 \itemize{
 \item \code{"plot"}
 \item \code{"table"}