Closed lwjohnst86 closed 1 year ago
@lwjohnst86 A few questions that have arisen as I start to implement this:
I'm following the py-rse convention of adding section labels that start with chapter slug, then section/subsection label, e.g.
# Setting up an R package {#package-setup}
## Why create an R package? {#package-setup-why}
Is this OK?
In py-rse, exercise sections had labels that started with the chapter slug, followed by ex-
, e.g.
### Exercise: Explore the structure of a package {#package-setup-ex-structure}
Are we sticking with that too?
For code chunks, should the chunk label also include the chapter slug or section/exercise label, or can we figure that out programmatically? For instance, the above exercise might have the chunks:
```{r es-install, eval = FALSE}
remotes::install_github("merely-useful/XXX")
```
```{r es-run}
library(XXX)
xxx()
yyy
```
Should the chunk labels be es-package-setup-ex-structure-install
and es-package-setup-ex-structure-run
? Or maybe es-structure-install
and es-structure-run
?
If I remember our conversation about this correctly, we had decided NOT to include the chapter slug because:
Will close this with a PR I will submit soon, since the move to Quarto has changed a lot of these things. But not substantially.
This is a work-in-progress and something we should discuss.
There are a few steps to take to ensure we all fit with each other and so that other tasks are easier to do in the end.
1. Reformat all current content into a specific format
Before adding any content around the code steps and exercises, first we each need to reformat things into consistent and similar formats. Start by structuring chapters into sections and form the sections:
Exercise: Exercise Name {#ex-EXERCISE-TAG}