Reorg NPM package dependencies, rename site folder to docsy.dev

[chalin]

• Fixes [CI/infra] Rework NPM package dependencies #2115!
• Reorganizing the repo so that the website is a private subpackage.
• Contributes to Docsy as an NPM package: publish package, adjust dev deps, and document choices #2172. Project using Docsy were still facing problems due to peer deps.
  • For example, see the build jobs of Update dependency hugo-extended to v0.151.0 jaegertracing/documentation#949
  • Moves all non-essential packages to the website subpackage.
  • Streamlined the NPM scripts
• Renames userguide to docsy.dev, since that's what it is: it's a subpackage to build the website

[Copilot]

Pull Request Overview

This PR reorganizes the repository structure by renaming the userguide folder to docsy.dev and restructuring NPM package dependencies to address peer dependency issues. The website is now configured as a private workspace subpackage, with non-essential dependencies moved from the root package to the website subpackage.

Key changes:

• Renamed userguide directory to docsy.dev throughout the codebase
• Converted the repository to use NPM workspaces with docsy.dev as a private subpackage
• Moved development dependencies (hugo-extended, netlify-cli, npm-check-updates, cross-env) from root peer dependencies to the docsy.dev subpackage
• Streamlined NPM scripts to use cd:docsy.dev instead of cd:docs

Reviewed Changes

Copilot reviewed 19 out of 90 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
package.json	Configured workspaces, removed peer dependencies, moved tools to subpackage, updated script references
docsy.dev/package.json	Added development dependencies previously in root, marked as private package
netlify.toml	Updated build commands and publish directory path
scripts/make-site.sh	Added cSpell ignore comment for script-specific terms
docsy.dev/scripts/install-hugo.sh	Updated Hugo version detection to read from config object
docsy.dev/static/refcache.json	Updated cached URL references from userguide to docsy.dev
docsy.dev/hugo.yaml	Updated github_subdir parameter
docsy.dev/content/*	Updated documentation references to use new folder name
docker-compose.yaml	Updated image name and volume mount paths
Dockerfile	Updated working directory paths
README.md	Updated quick start instructions
CONTRIBUTING.md	Updated release process documentation
.vscode/cspell.json	Added nvmrc to spelling dictionary
.github/workflows/*.yaml	Updated workflow scripts and added artifact uploads

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}