Add FAQ vignette

.gitignore

@@ -3,3 +3,4 @@
 .RData
 .Ruserdata
 docs
+inst/doc

DESCRIPTION

@@ -21,6 +21,9 @@ Imports:
     rlang
 Suggests: 
     httptest2,
+    knitr,
+    rmarkdown,
     testthat (>= 3.0.0),
     withr
 Config/testthat/edition: 3
+VignetteBuilder: knitr

R/bypass_2fa.R

@@ -1,5 +1,8 @@
 #' Allow/disallow bypassing of two factor authentication for workgroup
 #'
+#' @description More information on two factor authentication can be found in
+#' `vignette("faqs")`.
+#'
 #' @param workgroup_uuid Workgroup UUID
 #' @param allow_bypass Logical to indicate whether the workgroup should allow
 #' selected participants to bypass two step workspace verification.
@@ -32,14 +35,16 @@ allow_bypass_2fa <- function(workgroup_uuid,
 
 #' Allow/disallow bypassing of two factor authentication for participant
 #'
+#' @description Note that this setting can only be updated by a workspace owner.
+#' More information on two factor authentication can be found in
+#' `vignette("faqs")`.
+#'
 #' @param participant_uuid Participant UUID (note that this is different to the
 #' user UUID)
 #' @param allow_bypass Logical to indicate whether the participant should be
 #' able to bypass two step verification for workspace.
 #' @inheritParams objectiveR
 #'
-#' @details Note: This setting can only be updated by a workspace owner.
-#'
 #' @export
 
 participant_bypass_2fa <- function(participant_uuid,

vignettes/.gitignore

@@ -0,0 +1,2 @@
+*.html
+*.R

vignettes/faqs.Rmd

@@ -0,0 +1,29 @@
+---
+title: "Frequently Asked Questions"
+output: rmarkdown::html_vignette
+vignette: >
+  %\VignetteIndexEntry{Frequently Asked Questions}
+  %\VignetteEngine{knitr::rmarkdown}
+  %\VignetteEncoding{UTF-8}
+---
+
+## What is the difference between users and participants?
+
+A user is an individual using Objective Connect. A participant is a user in a particular workspace. For example, a person using Objective Connect will have a User UUID associated with them, and also a Participant UUID for each individual workspace they are a member of. 
+
+A user can get their User UUID by running `my_user_id()`. A user can find their participant UUID for a particular workspace using `participants()`.
+
+
+## How does two factor authentication (2FA) work?
+
+(Note: this is sometimes also referred to as 'two step verification'.)
+
+Where workspaces have 2FA enabled, users cannot use the API unless they have been given permission to bypass this. Permission to bypass 2FA is given at a workspace level, and can only be granted by the workspace owner.
+
+Firstly, permission must be given at a workgroup level to allow bypassing permissions to be granted for workspaces within it. This can be done using `allow_bypass_2fa()`.
+
+Once this has been allowed, bypassing can be granted for individual participants in a workspace using `participant_bypass_2fa()`. 
+
+Both of these functions also allow for bypassing to be disallowed using `allow_bypass = FALSE`.
+
+To check the status of bypassing 2FA for participants in a workspace, use `participants()`.