diff --git a/_quarto.yml b/_quarto.yml index fc3e929..4487ba9 100644 --- a/_quarto.yml +++ b/_quarto.yml @@ -23,7 +23,7 @@ book: - api-for-an-analysis.qmd - part: "Personal R Administration" chapters: - - project-workflow-meta.qmd + - personal-radmin.qmd - r-startup.qmd - installing-packages.qmd - reproducible-environments.qmd diff --git a/img/project-oyster.svg b/img/project-onion.svg similarity index 100% rename from img/project-oyster.svg rename to img/project-onion.svg diff --git a/img/r-project-oyster.svg b/img/r-project-onion.svg similarity index 100% rename from img/r-project-oyster.svg rename to img/r-project-onion.svg diff --git a/personal-radmin.qmd b/personal-radmin.qmd index aeeb85c..97875ed 100644 --- a/personal-radmin.qmd +++ b/personal-radmin.qmd @@ -1,13 +1,49 @@ -# Personal R Administration +--- +title: "Meta Project-Oriented Workflow" +--- +The goal of these chapters is to help you build a system for answering questions like: +- How do I upgrade the version of R I'm using for this project? +- How do I track which package versions I'm using for this project? +- How do I move this project from one computer to another? + +across many projects and many computers. + +This system takes the principles articulated in "Holistic Workflow" and extends them to all the ways you might use R, but also to other software you use. + +## The Project Onion + +Going all in on the project-oriented workflow means adopting tools that make it possible to programmatically manage each of the layers of project setup, which can be visualized via the "project onion": + +![the project onion](./img/project-onion.svg "package managers install language managers install language verions which install environments") + +### package managers + +### language manager + +### language version + +### environment manager + +### your project + +## The Project Onion: R + +![the project onion, R](./img/r-project-onion.svg "scoop install rig; rig install 4.3.0; rig rstudio projects/myproject/renv.lock") + + +## The Workflow Cycle ```{mermaid} -flowchart TD -inst(Installing & Upgrading R) -start(Starting R) -pkg(Installing Packages) -repro(Reproducible Environments) +flowchart LR -start --> pkg --> repro --> inst --> start +start(starting R) +packages(installing R packages) +repro(creating reproducible environments) +installing("installing | upgrading R") + +start --> packages --> repro --> installing --> start ``` + +If you go all in on the project-oriented workflow, installing R and upgrading R are the same operation. diff --git a/project-workflow-meta.qmd b/project-workflow-meta.qmd deleted file mode 100644 index 8fb6c2a..0000000 --- a/project-workflow-meta.qmd +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: "Project Workflow: the meta" ---- - -## the cycle - -```{mermaid} -flowchart LR - -start(starting R) -packages(installing R packages) -repro(creating reproducible environments) -installing("installing | upgrading R") - -start --> packages --> repro --> installing --> start -``` - -If you go all in on the project-oriented workflow, installing R and upgrading R are the same operation. - -## the project onion - -Going all in on the project-oriented workflow means adopting tools that make it possible to programmatically manage each of the layers of project setup: - -![the project onion](./img/project-oyster.svg "package managers install language managers install language verions which install environments") - -## the project onion: R - -![the project onion, R](./img/r-project-oyster.svg "scoop install rig; rig install 4.3.0; rig rstudio projects/myproject/renv.lock") \ No newline at end of file