Advise pak for installing packages

Author: matt-dray

README.Rmd

@@ -40,16 +40,18 @@ The app is built and maintained by members of [the Strategy Unit's Data Science
 Technically there are two apps: the main app in the `main` branch, and the inputs selection app (where users start or edit a scenario) in the `inputs_selection_app` branch.
 Users arrive at the selection app before being routed to the main app. 
 
-Both apps are built with [Shiny](https://shiny.posit.co/) and the main app uses the [the {golem} package](https://thinkr-open.github.io/golem/). Server and UI modules can be found in `R/`, configuration in `inst/golem-config.yml` and supporting data and text in `inst/app/`.
-
-Packages used in the app are listed in `DESCRIPTION`, and can be installed with `devtools::install_deps(dependencies = TRUE)`.
+Both apps are built with [Shiny](https://shiny.posit.co/) and the main app uses the [the {golem} package](https://thinkr-open.github.io/golem/).
+Server and UI modules can be found in `R/`, configuration in `inst/golem-config.yml` and supporting data and text in `inst/app/`.
 
 ### Run locally
 
 Run the app locally on your machine to test that your changes work as expected.
 
-To prepare, add an `.Renviron` file to the project root that contains the required environment variables. There is an `.Renviron.example` file which describes the required variables.
-You can get these from a member of the Data Science team.
+First, install the required packages listed in the DESCRIPTION with `pak::local_install_deps(dependencies = TRUE)`.
+
+Then add an `.Renviron` file to the project root that contains the required environment variables.
+Copy into it the required variables, which are listed in the `.Renviron.example`.
+You can get the values you need from a member of the Data Science team.
 
 Then, from the `main` branch (or your development branch of it), use Git's `worktree` function to put the `inputs_selection_app` branch (or your development branch of it) in its own subfolder. 
 
@@ -60,6 +62,7 @@ git fetch origin inputs_selection_app
 git worktree add inputs_selection_app inputs_selection_app
 ```
 
+The first argument is the name of the folder in which to put the branch content.
 If you want a development version of the inputs selection app, you can specify the branch name as the second of the arguments to `git worktree add`.
 
 To run the app from RStudio, start up the selection app by opening the `dev/watch.R` script, go to the 'Background Jobs' tab of the console pane and click the 'Start Background Job' button.
@@ -84,7 +87,7 @@ To test the unreleased app in our development environment:
 
 1. Merge any PRs you want to test into the `main` branch.
 2. If you've changed any dependencies, run `dev/generate_manifest.R` to update `manifest.json`.
-3. If you've made any changes to the inputs selection app, run the manual `deploy()` call under the 'development' heading in the `deploy.R` script in your selection app development branch.
+3. If you've made any changes to the inputs selection app, run the manual `deploy()` call under the 'development' heading in the `deploy.R` script in your selection-app development branch.
 
 When using the dev inputs selection app on Connect, make sure to set the 'Model Version' dropdown to 'dev' in the expandable 'Advanced Options' box.
 That way you'll be taken to the dev inputs app when you hit 'Start'.