Driver/R: Add dedicated page

Author: amotl

docs/connect/index.md

@@ -97,6 +97,18 @@ CrateDB drivers and adapters for supported programming languages, frameworks, an
 {fab}`python`
 ::::
 
+::::{grid-item-card} R
+:link: connect-r
+:link-type: ref
+:link-alt: Connect to CrateDB using R
+:padding: 3
+:text-align: center
+:class-card: sd-pt-3
+:class-body: sd-fs-1
+:class-title: sd-fs-6
+{fab}`r`
+::::
+
 ::::{grid-item-card} Ruby
 :link: connect-ruby
 :link-type: ref
@@ -186,6 +198,7 @@ java
 javascript
 php
 python
+r
 ruby
 natural
 All drivers <drivers>

docs/connect/r.md

@@ -0,0 +1,57 @@
+(connect-r)=
+
+# R
+
+:::{div} sd-text-muted
+Connect to CrateDB from R applications and notebooks.
+:::
+
+:::{rubric} About
+:::
+
+[RPostgreSQL] is the canonical _R Interface to the 'PostgreSQL' Database System_.
+
+:::{rubric} Synopsis
+:::
+
+```r
+# Install driver on demand.
+# RPostgreSQL: R Interface to the 'PostgreSQL' Database System
+# https://cran.r-project.org/web/packages/RPostgreSQL/
+if (!require(RPostgreSQL)) {
+    install.packages("RPostgreSQL", repos="http://cran.us.r-project.org")
+}
+stopifnot(require(RPostgreSQL))
+
+# Load the DBI library.
+library(DBI)
+drv <- dbDriver("PostgreSQL")
+
+# Open a database connection, where `dbname` is the name of the CrateDB schema.
+con <- dbConnect(drv,
+                 host = "localhost",
+                 port = 5432,
+                 user = "crate",
+                 dbname = "testdrive",
+                 )
+
+# Invoke a basic select query.
+res <- dbGetQuery(con, "SELECT mountain, region, height FROM sys.summits ORDER BY height DESC LIMIT 3;")
+print(res)
+```
+
+## Example
+
+:::{card}
+:link: https://github.com/crate/cratedb-examples/tree/main/by-language/r
+:link-type: url
+{material-outlined}`play_arrow;2em`
+Connect to CrateDB and CrateDB Cloud using R.
++++
+Demonstrates a basic example that uses the R RPostgreSQL package.
+:::
+
+[![R](https://github.com/crate/cratedb-examples/actions/workflows/lang-r.yml/badge.svg)](https://github.com/crate/cratedb-examples/actions/workflows/lang-r.yml)
+
+
+[RPostgreSQL]: https://cran.r-project.org/web/packages/RPostgreSQL/