1047 intermediate guide

NEWS.md

@@ -1,9 +1,12 @@
 ## rtables 0.6.13.9004
 
 ### New Features
+ * Added Guided Tour section to the `pkgdown` site
+ * Added vignette: Guided Tour (Intermediate)
  * Added vignette: Guided Tour (Intermediate) - Translating Shells To Layouts @gmbecker
  * Added vignette: Guided Tour (Intermediate) - Identifying Required Analysis Behavior @gmbecker
-
+ * Added vignette: Guided Tour (Intermediate) - Identifying Required Faceting Behavior @gmbecker
+
 ## rtables 0.6.13
 
 ### New Features

_pkgdown.yml

@@ -60,8 +60,14 @@ articles:
     contents:
     - rtables
     - exploratory_analysis
+
+  - title: Guided Tour
+    navbar: Guided Tour
+    contents:
+    - guided_intermediate
     - guided_intermediate_translating_shells
     - guided_intermediate_afun_reqs
+    - guided_intermediate_split_reqs
 
   - title: Clinical Trials
     navbar: Clinical Trials

inst/WORDLIST

@@ -91,6 +91,8 @@ responder
 reusability
 roadmap
 sas
+sep
+SKELETOMUSCULAR
 sortable
 spl
 subsplits

vignettes/guided_intermediate.Rmd

@@ -0,0 +1,59 @@
+---
+title: "A Guided Tour of rtables - Intermediate"
+subtitle: Contributed by Johnson & Johnson Innovative Medicine
+date: "2025-06-17"
+author:
+- Gabriel Becker
+- Dan Hofstaedter
+output:
+    rmarkdown::html_document:
+        theme: "spacelab"
+        highlight: "kate"
+        toc: true
+        toc_float: true
+vignette: >
+  %\VignetteIndexEntry{A Guided Tour of rtables - Intermediate}
+  %\VignetteEngine{knitr::rmarkdown}
+  %\VignetteEncoding{UTF-8}
+editor_options:
+  markdown:
+      wrap: 72
+  chunk_output_type: console
+---
+
+# Scope and Audience
+
+Now that we have an understanding of how the `rtables` framework
+behaves mechanically from a user perspective, our next step is to
+build up intuition for how to leverage `rtables`' flexibility to
+create table outputs that go beyond simple straightforward structures.
+
+This portion of the guide is intended for users with a reasonable
+grasp of what the individual layouting instructions do by default who
+want to learn how to combine and customize their behavior to achieve
+complex structured tables when a library of suitable analysis, group
+summary, and split functions is already available. It is a good fit
+for users looking to leverage, e.g., `tern` or `junco` to create tables
+without writing custom functions themselves.
+
+Taking full control of tabulation behavior by creating our own
+functions, and understanding the layouting engine's default behavior
+will be covered in the upcoming advanced and introductory portions of
+this guide, respectively. In the meantime we refer readers looking for
+such content to the wide array of existing vignettes and documentation
+available beyond this guided tour.
+
+
+
+# Chapters
+
+- [Translating Shells To
+  Layouts](./guided_intermediate_translating_shells.html) -
+  Identifying key structural features in a table shell and mapping
+  them to rtables concepts
+- [Identifying Required Analysis
+  Behavior](./guided_intermediate_afun_reqs.html) - Reasoning about
+  analysis behaviors and choosing an `afun`
+- [Identifying Required Faceting
+  Behavior](./guided_intermediate_split_reqs.html) - Reasoning about
+  faceting and choosing a split function