Adding action to post artifact

[gvegayon]

This pull request updates the GitHub Actions workflow for building and deploying the pkgdown site. The most important changes include adding permissions for pull requests, saving artifacts, and posting artifacts to pull requests.

Enhancements to GitHub Actions workflow:

• .github/workflows/pkgdown.yaml: Added pull-requests: write permission to the permissions section.
• .github/workflows/pkgdown.yaml: Added steps to save the pkgdown-site artifact and post it to the pull request if the event is a pull request.

[github-actions]

Thank you for your contribution @zsusswein 🚀! Your pkgdown-site is ready for download 👉 here 👈!
_{(The artifact expires on 2024-11-01T13:34:03Z. You can re-generate it by re-running the workflow here.)}

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Additional details and impacted files

📢 Thoughts on this report? Let us know!

[zsusswein]

As part of this issue, it would be good to fix the broken bullet point rendering in the pkgdown website. It looks fine in the readme rendering, so it's a good test-case of what this can prevent in the future.

The issue has this task listed too. Is that something you'd be able to add here?

See this on the website:

[gvegayon]

I think fd5453e fixes the broken bullet. Also, the mermaid diagram is not rendering properly, but that is something I would address in a separate PR as it needs more coding.