# The duckdb-r handbook

The single source of truth
for every documentable aspect of this package;
internal pages like this one navigate and state their area's principles,
leaves explain ([`meta/handbook/`](/handbook/meta/handbook/README.md)).

The areas divide by what a question is about,
not by who is asking it.
A reader who only installs the package
and one who maintains the repository
are served by the same tree,
and the same question brings both to the same leaf —
an audience split would need the same fact in two places,
and the tree holds every fact once.

* [`usage/`](usage/) — installation and flavors, connections,
  statements, types, timestamps, extensions, memory, data import,
  storage, integrations, the relational API, interactive use
* [`architecture/`](architecture/) — the R layer, the C++ glue,
  the embedded engine, the `rfuns` extension
* [`build/`](build/) — source build, fast paths, build knobs
* [`testing/`](testing/) — suite, snapshots, guards, revdep
* [`branches/`](branches/) — series, mirrors, flavors, invariants
* [`operations/`](operations/) — vendoring, triage, review,
  CI, releases, the site
* [`contributors/`](contributors/) — setup, workflow, where to help
* [`meta/`](meta/) — the rules, the authoring checklist,
  the plans, the glossary
