diff --git a/.github/README.md b/.github/README.md new file mode 100644 index 00000000..48546e91 --- /dev/null +++ b/.github/README.md @@ -0,0 +1,8 @@ +# GitHub Workflows and Templates + +This folder contains the workflows to initiate: + +* the pull request template (`pull_request_template.md`) +* checks for the repository and code (e.g., code coverage check, code styling and adjustment, CMD check, spell check) (`workflows` folder) +* issue templates which translate to pre-made +templates that are shown when a user opens an issue in the repository (`ISSUE_TEMPLATE` folder) \ No newline at end of file diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 22a35abc..b6b2373f 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -3,10 +3,10 @@ Thanks for opening a PR. This commented text will **NOT** appear in the final PR --> # What is the feature? -* +* # How have you implemented the solution? -* +* # Does the PR impact any other area of the project, maybe another repo? -* +* diff --git a/R/README.md b/R/README.md new file mode 100644 index 00000000..ce9dabf6 --- /dev/null +++ b/R/README.md @@ -0,0 +1,7 @@ +# Functions + +This folder is composed of all the exported and utility functions used in {asar}. These utility functions are typically used to perform intermediary tasks in the process of making a report, and are run within the other functions. +Each script depicts the specific function within the file. The utility file functions include + +* `utils_tex.R`: utility functions that output LaTeX to modify asar reports +* `utils.R`: general helpful utility functions diff --git a/README.md b/README.md index 40a19898..c59ac009 100644 --- a/README.md +++ b/README.md @@ -73,7 +73,7 @@ output <- stockplotr::convert_output( ``` In this function, the users have the option to convert output files to a standardized -framework from either SS3 (Report.sso) or BAM (.rdat) output files. `asar` uses this +framework from either SS3 (Report.sso), BAM (.rdat), FIMS, or Rceattle output files. `asar` uses this converted output from the environment to calculate quantities in the preamble and it is also used for creating plots and tables from [`stockplotr`](https://github.com/nmfs-ost/stockplotr). diff --git a/inst/README.md b/inst/README.md new file mode 100644 index 00000000..71757de2 --- /dev/null +++ b/inst/README.md @@ -0,0 +1,20 @@ +# Inst + +This folder contains various files which support the creation of materials for running functions in {asar}. + +* WORDLIST contains a list of words that are used in the spell check workflow. It is a plain text file with one word per line. The words in this list are considered correct and will not be flagged as spelling errors during the spell check process. + +## Sub-folders + +* The `extdata` sub-folder contains an example of an SS3 report file that can be input into `convert_output()`. +* The `glossary` sub-folder contains the materials used to create the {asar} glossary (`report_glossary.tex`). +* The `resources` sub-folder contains files used in the development of {asar} reports. This includes: + * author affiliation information (`affiliation_info.csv`) + * citations for use in the report bibliography (`citations.bib`) + * citation formatting file in the style of the Canadian Journal of Fisheries and Aquatic Sciences (CJFAS) (`cjfas.csl`) + * LaTeX partials used to format the Quarto-based report (`formatting_files` folder) + * NOAA logo placed on report title page (`NOAA_Transparent_Logo.png`) + * `preamble` R file used to extract key quantities from model results file used in asar report (`preamble.R`) + * Images of species used for asar report cover pages (`spp_img` folder) + * US Dept of Commerce logo placed on report title page (`us_doc_logo.png`) +* The `templates` sub-folder contains the child documents used for each report "type": Northeast management track (nemt); Pacific Fisheries Marine Council (pfmc); Stock Assessment and Fishery Evaluation (safe); standard report format (skeleton) diff --git a/inst/WORDLIST b/inst/WORDLIST index ae6f0734..26227259 100644 --- a/inst/WORDLIST +++ b/inst/WORDLIST @@ -16,6 +16,7 @@ Drs ECOMON EcoMon Fabio +FIMS Flextable Gertseva Hardcoding @@ -39,6 +40,7 @@ Pandoc Pomatomus Pre Quillback +Rceattle README RStudio RTF @@ -78,6 +80,7 @@ frac gls goa hardcoding +href is’ jpg knitr diff --git a/inst/extdata/asar_cheatsheet.pdf b/inst/extdata/asar_cheatsheet.pdf deleted file mode 100644 index 0392ccbf..00000000 Binary files a/inst/extdata/asar_cheatsheet.pdf and /dev/null differ diff --git a/inst/resources/authorship.csv b/inst/resources/authorship.csv deleted file mode 100644 index da65e738..00000000 --- a/inst/resources/authorship.csv +++ /dev/null @@ -1,101 +0,0 @@ -last,first,mi,office -Adams,Charles,,NEFSC -Ailloud,Lisa,,SEFSC -Allen Akselrud,Caitlin,,SWFSC-LJCA -Berger,Aaron,M.,NWFSC-NOR -Beyer,Sabrina,,NWFSC-SWA -Bizzarro,Joseph,J.,SWFSC-SC -Blackhart,Kristan,,NEFSC -Boucher,Jason,,NEFSC -Brodziak,John,,PIFSC -Brown,Russell,W.,NEFSC-WHMA -Budrick,John,E.,CDFW -Carvalho,Felipe,,PIFSC -Chang,Jui-Han,,NEFSC -Chute,Toni,,NEFSC -Coates,Julia,H.,CDFW-SB -Cope,Jason,M.,NWFSC-SWA -Correa,Giancarlo,M.,AFSC -Curti,Kiersten,,NEFSC -Damiano,Matt,,SEFSC -Deary,Alison,L.,AFSC -Deroba,Jon,,NEFSC -Dick,E.,J.,SWFSC-SC -Dorn,Martin,W.,AFSC -Ducharme-Barth,Nicholas,,PIFSC -Dunn,Alex,,NEFSC -Feddern,Megan,L.,NWFSC-SWA -Ferriss,Bridget,E.,AFSC -Field,John,,SWFSC-SC -Fitchett,Mark,D.,PIFSC -Forrestal,Francesca,,SEFSC-MFL -Gertseva,Vladlena,,NWFSC-SWA -Haltuch,Melissa,A.,AFSC-WA -Hamel,Owen,S.,NWFSC-SWA -Hart,Dvora,,NEFSC -Hastie,Jim,,NWFSC-SWA -Havron,Andrea,,OST -Head,Melissa,A.,NWFSC-SWA -Hendrickson,Lisa,,NEFSC -Hennen,Dan,,NEFSC -Hernvann,Pierre-Yves,,NWFSC-SWA -Hill,Kevin,T.,SWFSC-LJCA -Hillier,Lisa,K.,WDFW -Hinton,Kristen,E.,WDFW -Johnson,Kelli,F.,NWFSC-SWA -Jones,Andy,,NEFSC -Kapur,Maia,S.,AFSC-WA -Kuriyama,Peter,T.,SWFSC-LJCA -Lam,Laurel,S.,PSMFC -Langseth,Brian,J.,NWFSC-SWA -Legault,Chris,,NEFSC -Levine,Mike,,AFSC -Marshall,Kristan,,NWFSC-SWA -Matson,Sean,E.,WCR -McGowan,David,W.,AFSC -Methot,Richard,,NWFSC -Monk,Melissa,H.,SWFSC-SC -Monnahan,Cole,C.,AFSC -Nieland,Julie,,NEFSC -Niles,Corey,B.,WDFW -Nitschke,Paul,,NEFSC -O'Keefe,Cate,,NEFSC -Oken,Kiva,L.,NWFSC-SWA -Oshima,Megumi,,PIFSC -Perretti,Charles,,NEFSC -Rios,Adyan,,SEFSC -Rogers,Lauren,,AFSC -Rogers,Tanya,L.,SWFSC-SC -Saas,Emma,M.,SWFSC-SC -Sagarese,Skyler,,SEFSC-MFL -Sculley,Michelle,,PIFSC -Shank,Burton,,NEFSC -Shertzer,Kyle,,SEFSC-BNC -Shotwell,S.,Kalei,AFSC -Siegfried,Katie,,SEFSC -Sosebee,Karson,,NEFSC -Spies,Ingrid,,AFSC-WA -Stawitz,Christine,,OST -Sullivan,Jane,Y.,AFSC -Syslo,John,,PIFSC -Taylor,Ian,G.,NWFSC-SWA -Tolimieri,Nick,,NWFSC-SWA -Traver,Michele,,NEFSC -Tsou,Tien-Shui,,WDFW -Tyrell,Abigail,,NEFSC -Veron,Matthieu,,AFSC-WA -Wallace,John,R.,NWFSC-SWA -Wassermann,Sophia,N.,AFSC-WA -Wetzel,Chantel,R.,NWFSC-SWA -Whitman,Alison,D.,ODFW -Wigley,Susan,,NEFSC -Williams,Ben,,AFSC -Williams,Erik,,SEFSC -Wood,Anthony,,NEFSC -Yau,Annie,J.,PIFSC -Zador,Stephani,,AFSC -Zahner,Joshua,A.,UAF -Zwolinski,Juan,P.,SWFSC-LJCA -Snow,John,,AFSC -Phantom,Danny,,NEFSC -Star,Patrick,,SEFSC-MFL diff --git a/tests/README.md b/tests/README.md new file mode 100644 index 00000000..f718c4b4 --- /dev/null +++ b/tests/README.md @@ -0,0 +1,9 @@ +# Tests + +This folder contains tests for the functions in {asar}. The tests are located in the sub-folder "testthat". We follow the testing structure and approach found using {testthat} R package. Each function should have its own test. If a new function is made, you can create a new testing script by running the following in the console: + +``` +usethis::use_test() +``` + +The above function references whatever function is currently open. From there, use the options for testing in the testthat package, make your own testing function, or reference the current tests in this folder. \ No newline at end of file diff --git a/vignettes/README.md b/vignettes/README.md new file mode 100644 index 00000000..5e15016e --- /dev/null +++ b/vignettes/README.md @@ -0,0 +1,31 @@ +# Vignettes + +The `articles` sub-folder contains the articles (a special type of vignette) found in the [asar website](https://nmfs-ost.github.io/asar/) under the +"Articles" drop-down tab. + +Note that these files are "articles", rather than "vignettes". We chose articles over vignettes because these documents benefited from having features available to Quarto documents (like a floating table of contents) but not simple markdown documents. As a result, these articles appear on the package website but are not included in the user-facing package. + +To create a new article, create a new quarto file then add this information as the yaml: + +``` +title: "My Title" +format: + html: + toc: true + toc-depth: 3 + anchor-sections: true + other-links: + - text: stockplotr + href: https://nmfs-ost.github.io/stockplotr/ +knitr: + opts_chunk: + collapse: true + comment: '#>' +bibliography: references.bib +``` + +Afterwards, edit the `_pkgdown.yml` file located in the `pkgdown` folder. The new article can be added under the "articles:" then "menu:" lines. Please include: + +* text -- the title that's presented to the site visitor when looking at the drop-down menu +* href -- the path to the vignette file. It should be "articles/{name_of_file}.qmd" +