v1.5.0

[Schiano-NOAA]

TLDR::

• Major improvements to asar::convert_output()
• New csl file for formatting citations
• Updated tagging
• Expanded information in vignettes (FAQs and alternative text guidance)

✍️ Summary

Since our last release, we have had identified various bugs and suggestions for improvement due to the increased use of asar across the country. The team has pushed a variety of hotfixes to v1.4.0, but we have made additional strides to improve the tool with this release, v1.5.0. We want to particularly highlight the improvements to the convert_output() function and improved formatting settings like adding a .csl file for citation formatting and improving add_tagging(). The team is in the midst of getting a pre-release ready for our sister package, stockplotr. We hope the improvements on this release only make the tool better! Additional contributions are welcome through a PR or feel free to file an issue if you find any bugs or have an idea for improvement to the tool.

🆕 Updates

Major Changes (user impact)

• New asar cheatsheet available!
• New code of conduct policy implemented for contributors and developers
• Major improvements to efficiency of convert_output() when running converting a Stock Synthesis model output
• convert_output() now recognizes which model the output originated
• FIMS is now compatible with convert_output()!
• Other quality of life improvements and bugs fixed in asar::convert_output
• stockplotr was removed as a dependency of asar
• Notation for tagging is updated to the most recent recommendation from the tagpdf LaTeX package
• Language is no longer set in the skeleton yaml. Instead, it is identified by tagpdf call when running asar::add_tagging()` (This is a required part of making documents section 508 compliant)
• Region is now an included parameter in the params chunk making it available to reference throughout the document by the author
• Explicit style guidelines identified for references to prevent errors in the form of a .csl file created when create_template() is run. Based on reference style guidelines from Canadian Journal of Fisheries and Aquatic Sciences
• More FAQs available
• Clearer messaging when author is missing or improperly added when making a template
• Updates to recommended addition of alternative text and captions when adding non-stockplotr tables and figures
• When adding more figures and tables from the same respective folders and the quarto files for these objects already exist, they are appended to the file

Minor Changes (dev)

• README example was updated
• Improved testing framework
• Updates to GitHub actions in the package repository
• returns() removed from the end of functions per best practice
• General changes to incorporate suggestions from {goodpractice} R package

🌟 Shout outs to our new contributors!

• @ClaireGonzales-NOAA made their first contribution in Addregion dev #333
• @Andrea-Havron-NOAA made their first contribution in remove return(x) from end of function #334
• @e-perl-NOAA ran {goodpractice} check

Full Changelog: v1.4.0...v1.5.0

---

This discussion was created from the release v1.5.0.