GHA: add a workflow to build the pkgdown site on PR

[Bai-Li-NOAA]

What is the feature?

This PR addresses issue #595. It enables FIMS to render the pkgdown site on pull requests.

How have you implemented the solution?

Thanks, @k-doering-NOAA, for adding a reusable workflow to {ghactions4r}. The workflow call-build-pkgdown.yml has been added to FIMS to use this reusable workflow.

Does the PR impact any other area of the project?

No

How to test this change

It has been tested on the feature branch, and the pkgdown site materials have been successfully uploaded on Actions page here

Developer pre-PR checklist

• I relied on GitHub actions to 🧪 things for me while I sat on the 🛋️.

[github-actions]

Instructions for code reviewer

Hello reviewer, thanks for taking the time to review this PR!

• Please use this checklist during your review, checking off items that you have verified are complete!
• For PRs that don't make changes to code (e.g., changes to README.md or Github actions workflows), feel free to skip over items on the checklist that are not relevant. Remember it is still important to do a thorough review.
• Then, comment on the pull request with your review indicating where you have questions or changes need to be made before merging.
• Remember to review every line of code you’ve been asked to review, look at the context, make sure you’re improving code health, and compliment developers on good things that they do.
• PR reviews are a great way to learn, so feel free to share your tips and tricks. However, for optional changes (i.e., not required for merging), please include nit: (for nitpicking) before making the suggestion. For example, nit: I prefer using a data.frame() instead of a matrix because...
• Engage with the developer when they respond to comments and check off additional boxes as they become complete so the PR can be merged in when all the tasks are fulfilled. Make it clear when this has been reached by commenting on the PR with something like This PR is now ready to be merged, no changes needed.

Checklist

• The PR is requested to be merged into the appropriate branch (typically main)
• The code is well-designed.
• The functionality is good for the users of the code.
• Any User Interface changes are sensible and look good.
• The code isn’t more complex than it needs to be.
• Code coverage remains high, indicating the new code is tested.
• The developer used clear names for everything.
• Comments are clear and useful, and mostly explain why instead of what.
• Code is appropriately documented (doxygen and roxygen).

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 78.56%. Comparing base (2c16ff4) to head (6f86bcc).
Report is 1 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #626   +/-   ##
=======================================
  Coverage   78.56%   78.56%           
=======================================
  Files          36       36           
  Lines        1945     1945           
  Branches      141      141           
=======================================
  Hits         1528     1528           
  Misses        374      374           
  Partials       43       43           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[k-doering-NOAA]

Hi @Bai-Li-NOAA , sorry for the delay on this! I had one question, but otherwise I think it looks good.

[k-doering-NOAA]

Sorry for dropping the ball on this one - looks ready to merge in to me!

@kellijohnson-NOAA I'll leave this for you to decide how you would like to merge in (I assume rebasing to catch up, then rebase in, but I wasn't sure)

[Bai-Li-NOAA]

Thank you, @k-doering-NOAA. I have rebased the branch.