From 6080e161943ca50bdba812f14cc0d5e7cc360a92 Mon Sep 17 00:00:00 2001 From: Jana Stoilova <43623360+anajens@users.noreply.github.com> Date: Wed, 6 Dec 2023 16:26:38 -0500 Subject: [PATCH] Update introduction vignette (#716) --- NEWS.md | 1 + _pkgdown.yml | 1 + man/figures/rtables-basics.png | Bin 0 -> 47908 bytes vignettes/introduction.Rmd | 219 +++++++++++++---------------- vignettes/introspecting_tables.Rmd | 136 ++++++++++++++++++ 5 files changed, 234 insertions(+), 123 deletions(-) create mode 100644 man/figures/rtables-basics.png create mode 100644 vignettes/introspecting_tables.Rmd diff --git a/NEWS.md b/NEWS.md index 4b7faf982..9256d3c90 100644 --- a/NEWS.md +++ b/NEWS.md @@ -30,6 +30,7 @@ * When tables are exported as `txt`, they preserve the horizontal separator of the table. * Added imports on `stringi` and `checkmate` as they are fundamental packages for string handling and argument checking. + * Updated introduction vignette and split it into two. Section on introspecting tables is now located in a separate vignette. ## rtables 0.6.5 ### New Features diff --git a/_pkgdown.yml b/_pkgdown.yml index 41db5436e..5ed84d73c 100644 --- a/_pkgdown.yml +++ b/_pkgdown.yml @@ -76,6 +76,7 @@ articles: - split_functions - format_precedence - tabulation_concepts + - introspecting_tables - title: Advanced Usage contents: diff --git a/man/figures/rtables-basics.png b/man/figures/rtables-basics.png new file mode 100644 index 0000000000000000000000000000000000000000..4ef55dd4c6605184274d65aefc6f782092b9806f GIT binary patch literal 47908 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

rNa$6l>AzHjWkm)^KU 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