# <Chapter title> {#chapter-id}

<!--
  Page template for the TADA-Wiki.

  1. Copy to `NN-chapter-id.Rmd` at the top level.
  2. Register the filename in `_bookdown.yml` under `rmd_files`.
  3. Build with `Rscript render.R` and check `docs/index.html`.

  The sourcing rule: separate what the source papers say from what you are
  adding. Cite the former by author and year; put the latter in a Wiki Tip box (::: {.tada-wiki}).
  Delete these comments before committing.
-->

::: {.tada-key}
One paragraph stating the point of this chapter. If a reader only takes away
this box, what should it be?
:::

Two or three sentences of context: who this chapter is for, and what they
should be able to do at the end of it.

## <First section> {#chapter-id-first}

Prose. Second person, present tense. State the guideline, then give the reason
for it.

::: {.tada-note}
A caveat, exception, or aside.
:::

## <A section with tabs> {#chapter-id-tabs}

Tabs suit parallel material: the same task in R and in Python, or a set of
alternatives the reader chooses between. They do not suit sequential material,
because only one pane is visible at a time.

::: {.tabset}

### R {.unlisted .unnumbered}

```r
# Illustrative only: chunks are not executed at build time.
library(here)
dat <- read.csv(here("data", "raw", "example.csv"))
```

### Python {.unlisted .unnumbered}

```python
from pyprojroot import here
import pandas as pd

dat = pd.read_csv(here("data/raw/example.csv"))
```

:::

## <A before/after comparison> {#chapter-id-compare}

Use `::::` for the outer fence. Pandoc nests same-width fences correctly either
way, but the wider outer fence makes the grouping obvious.

:::: {.tada-compare}
::: {.tada-before}
Before

```r
setwd("C:/Users/me/project")
```

One sentence on why this breaks.
:::

::: {.tada-after}
After

```r
library(here)
```

One sentence on why this works.
:::
::::

::: {.tada-tip}
A concrete, actionable suggestion.
:::

::: {.tada-wiki}
Your own practical advice, which is not from a source paper.
:::

::: {.tada-warn}
A common, costly mistake.
:::

## Checklist {#chapter-id-checklist}

End substantial chapters with items a reader can verify in under a minute each.

- [ ] <Something checkable>
- [ ] <Something checkable>

**Next:** [<Next chapter>](#next-chapter-id)

<!--
  Anything you cited above must be added to `13-references.Rmd`,
  alphabetically by first author, in the existing format.
-->