Migrate doc sites to MkDocs

[Goooler]

https://squidfunk.github.io/mkdocs-material

---

• CHANGELOG's "Unreleased" section has been updated, if applicable.

[Copilot]

PR Overview

This PR migrates the documentation site to MkDocs, updating associated links and workflows to support this change.

• Adds a new docs/README.md with updated MkDocs content
• Updates changelog links and release instructions in multiple files
• Revises the GitHub release workflow to deploy the MkDocs site

Reviewed Changes

File	Description
docs/README.md	New documentation page with MkDocs content
.github/workflows/release.yml	Updates build steps and adds a site deployment step
README.md	Adjusts changelog link to the new docs path
.github/pull_request_template.md	Updates changelog link reference
RELEASING.md	Updates changelog link reference

Copilot reviewed 40 out of 40 changed files in this pull request and generated 1 comment.

[Goooler]

View the new site

• https://github.com/GradleUp/shadow/tree/e2ba7a45b9c458503bf0fa52d4d1e85aca4a276b
• https://gradleup.com/shadow

[Goooler]

/gemini review

[gemini-code-assist]

Code Review

This pull request migrates the documentation sites to MkDocs, a static site generator that uses Markdown files. The changes include updating file paths, removing VuePress-related files, and configuring MkDocs for deployment. Overall, the changes seem well-structured and necessary for the migration.

Summary of Findings

• Removal of node_modules and VuePress files: The pull request removes node_modules and VuePress-related files, which is expected as part of migrating to MkDocs. This helps to clean up the repository and remove unnecessary dependencies.
• File path updates: Several file paths are updated to reflect the new documentation structure. This ensures that links and references point to the correct locations in the MkDocs site.
• Workflow updates: The release workflow is updated to include steps for installing MkDocs, deploying the site, and extracting release notes from the correct location. This ensures that the documentation site is automatically updated on releases.

Merge Readiness

The pull request appears to be well-structured and necessary for migrating the documentation sites to MkDocs. However, I recommend verifying that the new documentation site is functioning correctly and that all links and references are working as expected. I am unable to approve this pull request, and recommend that others review and approve this code before merging. Given that there are no critical or high severity issues, the pull request seems to be in good shape to be merged after the verification.