Update the documentation for the overlay position

Author: csouchet

R/funs.R

@@ -3,7 +3,7 @@
 #' @description
 #' To specify the position when creating an overlay object that will be attached to BPMN \code{Shape} elements in the diagram.
 #'
-#' \code{overlay_shape_position} includes the following positions:
+#' @section \code{overlay_shape_position} includes the following positions:
 #'
 #' - \code{"top-left"}
 #' - \code{"top-right"}
@@ -14,8 +14,16 @@
 #' - \code{"middle-left"}
 #' - \code{"middle-right"}
 #'
+#' @details
 #' Use these constants as the \code{position} argument in the \code{\link{create_overlay}} function.
 #'
+#' @examples
+#' # Create an overlay at the top-left corner of a shape
+#' overlay <- create_overlay(elementId = 1, label = "My label", position = overlay_shape_position[1])
+#'
+#' @seealso
+#' \code{\link{create_overlay}}
+#'
 #' @export
 overlay_shape_position <-
   c(
@@ -34,13 +42,21 @@ overlay_shape_position <-
 #' @description
 #' To specify the position when creating an overlay object that will be attached to BPMN \code{Edge} elements in the diagram.
 #'
-#' \code{overlay_edge_position} includes the following positions:
+#' @section \code{overlay_edge_position} includes the following positions:
 #' - \code{"start"}
 #' - \code{"end"}
 #' - \code{"middle"}
 #'
+#' @details
 #' Use these constants as the \code{position} argument in the \code{\link{create_overlay}} function.
-#' 
+#'
+#' @examples
+#' # Create an overlay at the starting point of an edge
+#' overlay <- create_overlay(elementId = 1, label = "My label", position = overlay_edge_position[1])
+#'
+#' @seealso
+#' \code{\link{create_overlay}}
+#'
 #' @export
 overlay_edge_position <- c("start", "end", "middle")