Docs: Troubleshooting renv section

docs/troubleshooting.md

@@ -50,6 +50,25 @@ For example, in [Posit Connect 2024.12.0](https://docs.posit.co/connect/news/#po
 Gradio app support was introduced. When deploying a Gradio app to a server
 running an older version of Posit Connect than 2024.12.0, it will error.
 
+## `renv` errors on deployment
+
+When deploying `R` projects, it is essential that Posit Publisher has
+access to a record of the dependencies used by your project to reproduce
+the project on Posit Connect.
+The [`renv` package](https://rstudio.github.io/renv/articles/renv.html) can
+create that record as a `lockfile` (commonly named `renv.lock`).
+
+Projects that already include a `lockfile` do not require `renv` be setup.
+
+If an R project doesn't have a `lockfile` on deploy, Posit Publisher prompts to
+provide a solution to generate the expected `lockfile`.
+
+![](https://cdn.posit.co/publisher/assets/img/publisher-renv-setup-notification.png)
+
+When uncommon errors occur that Posit Publisher cannot solve for you, it
+prompts to evaluate the status of `renv` using
+[`renv::status()`](https://rstudio.github.io/renv/reference/status.html).
+
 ## Still having trouble?
 
 If you're still having trouble with Posit Publisher or have any questions,