fix: update DESCRIPTION title formatting and improve snippets installation details

Author: ddotta

DESCRIPTION

@@ -1,6 +1,6 @@
 Package: quartify
 Type: Package
-Title: Convert R Scripts to Quarto Markdown Documents
+Title: Convert R Scripts to 'Quarto' Markdown Documents
 Version: 1.1.1
 Authors@R: c(
     person("Damien", "Dotta", , "damien.dotta@live.fr", role = c("aut", "cre", "cph"))

R/snippets.R

@@ -12,7 +12,10 @@
 #' - **tabset**: Insert a tabset structure
 #'
 #' @details
-#' The snippets are installed in your RStudio snippets file for R:
+#' By default the snippets are written to a temporary file (inside `tempdir()`)
+#' to comply with CRAN's restriction on writing to the user's filespace during
+#' examples, vignettes, and tests. To install in your actual RStudio snippets
+#' file, provide the explicit path via `path`, for example:
 #' - Windows: `%APPDATA%/RStudio/snippets/r.snippets`
 #' - Mac/Linux: `~/.config/rstudio/snippets/r.snippets`
 #'
@@ -27,8 +30,9 @@
 #'
 #' @param backup Logical. If TRUE (default), creates a backup of your existing
 #'   snippets file before modifying it.
-#' @param path Character. Custom path for the snippets file. If NULL (default),
-#'   uses the standard RStudio snippets location. For examples/tests, use tempdir().
+#' @param path Character. Path for the snippets file. Defaults to writing in
+#'   `tempdir()` to comply with CRAN policies. Provide an explicit path when you
+#'   intentionally want to install into your RStudio snippets directory.
 #'
 #' @return Invisibly returns the path to the snippets file.
 #'
@@ -46,7 +50,7 @@
 #' # For testing: install to temp directory
 #' temp_snippets <- file.path(tempdir(), "r.snippets")
 #' install_quartify_snippets(path = temp_snippets)
-install_quartify_snippets <- function(backup = TRUE, path = NULL) {
+install_quartify_snippets <- function(backup = TRUE, path = file.path(tempdir(), "r.snippets")) {
   # Define the snippets content
   snippets <- '
 # quartify snippets