🚸 Add setup vignette to website navbar (#132)

Co-authored-by: Alex Wolf <[email protected]>

_pkgdown.yml

@@ -19,6 +19,8 @@ navbar:
       text: Articles
       menu:
         - text: Introduction
+        - text: Setting up laminr
+          href: articles/setup.html
         - text: Concepts and features
           href: articles/concepts_features.html
         - text: Package Architecture

vignettes/setup.Rmd

@@ -37,6 +37,19 @@ install.packages("laminr", dependencies = TRUE)
 
 If you choose not to install all additional packages you will be prompted to do so as needed.
 
+## Installing the development version
+
+The current development version of **{laminr}** can be installed from GitHub using:
+
+```r
+if (!requireNamespace("laminr", quietly = TRUE)) {
+  install.packages("remotes")
+}
+remotes::install_github("laminlabs/laminr")
+```
+
+This version may have bug fixes and new features but could also be unstable so is not recommended for most users.
+
 # Installing Python **lamindb**
 
 Using **{laminr}** requires that the Python **lamindb** package is available.
@@ -78,12 +91,28 @@ Other Python packages you may want to install:
 
 Installing additional Python packages also be useful if you want to use another R package which expects a particular Python module to be installed.
 
-## Using another environment
+### Adding **lamindb** to another environment
+
+To install **lamindb** into another environment, set the `envname` argument:
+
+```r
+laminr::install_lamindb(envname = "your-env")
+```
+
+Be aware that there may be dependency conflicts with packages already installed in the environment and installing **lamindb** may cause package versions to change.
+
+## Setting the Python environment
+
+Running `library(laminr)` will tell **{reticulate}** to use the included `r-lamindb` environment (if it has not already connected to another environment).
+
+If you prefer to not load the whole package, and instead call functions using `laminr::`, you should tell **{reticulate}** which environment to use by running `reticulate::use_virtualenv("r-lamindb")`.
+
+### Using another environment
 
 In some cases you may prefer to use another Python environment.
 This may be the case if you use another R package which requires a Python module or if you are managing your own Python environment.
 
-Specifying another Python environment to use should be done ***before*** loading **{laminr}** using one of these methods:
+Specifying another Python environment to use should be done ***before*** loading **{laminr}** (or **{reticulate}**) using one of these methods:
 
 - Loading another R package that sets the Python environment
 - Using `reticulate::use_virtualenv()`, `reticulate::use_condaenv()` or `reticulate::use_python()`
@@ -92,16 +121,6 @@ Specifying another Python environment to use should be done ***before*** loading
 Details of the current Python environment can be viewed using `reticulate::py_config()`.
 For more information about setting the active Python environment see `vignette("versions", package = "reticulate")` (also [available here](https://rstudio.github.io/reticulate/articles/versions.html)).
 
-### Adding **lamindb** to another environment
-
-To install **lamindb** into another environment, set the `envname` argument:
-
-```r
-laminr::install_lamindb(envname = "your-env")
-```
-
-Be aware that there may be dependency conflicts with packages already installed in the environment and installing **lamindb** may cause package versions to change.
-
 # Logging in to LaminDB
 
 If you have not used LaminDB before you will need to login to access public instances.