chore(make): standardize Makefile structure

[Sbragul26]

Notes for Reviewers

This PR makes the Makefiles consistent across [docs] repositories. It aligns the structure, targets, and commands used in the Makefiles.

Signed commits

• Yes, I signed my commits.

[gemini-code-assist]

Code Review

This pull request refactors the Makefile and package.json to introduce new local and Docker-based build, dependency checking, and testing targets. Feedback on these changes highlights two critical issues in the Makefile: first, parsing go.mod using grep and awk in the docker-update-modules target is fragile and should be replaced with go list -m; second, the docker-build-upstream target is missing the HUGO_MODULE_REPLACEMENTS environment variable, which is necessary to correctly build the upstream version.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.