chore: standardize Makefile npm scripts

Signed-off-by: Bhumika Garg <bhumikatech2024@gmail.com>

Author: Bhumikagarggg

Makefile

@@ -15,16 +15,13 @@
 include .github/build/Makefile.core.mk
 include .github/build/Makefile.show-help.mk
 
-#----------------------------------------------------------------------------
+# ---------------------------------------------------------------------------
 # Academy
 # ---------------------------------------------------------------------------
 
-## ------------------------------------------------------------
-----LOCAL_BUILDS: Show help for available targets
-
-## Local: Install site dependencies
-setup:
-	npm i
+# ---------------------------------------------------------------------------
+# MAINTENANCE: Show help for available targets
+# ---------------------------------------------------------------------------
 
 ## Verify required commands and local dependencies are present.
 check-deps:
@@ -33,50 +30,62 @@ check-deps:
 	@test -x node_modules/.bin/hugo || { echo "Error: Hugo binary not found in node_modules. Please run 'make setup' first."; exit 1; }
 	@echo "Dependencies check passed."
 
-## Build site for production (no drafts, no future, no expired content).
-build: check-deps check-go
+## Validate Go is installed
+check-go:
+	@echo "Checking if Go is installed..."
+	@command -v go > /dev/null || { echo "Go is not installed. Please install it before proceeding."; exit 1; }
+	@echo "Go is installed."
+
+## Update the academy-theme package to latest version
+theme-update: check-go check-deps
+	@echo "Updating to latest academy-theme..."
+	npm run update:theme
+
+#----------------------------------------------------------------------------
+# LOCAL_BUILDS: Show help for available targets
+#----------------------------------------------------------------------------
+
+## Install site dependencies
+setup:
+	npm install
+
+## Build site for local consumption
+build: check-go check-deps
 	npm run build:production
 
-## Build site for preview (includes drafts, future, and expired content) with dynamically set baseURL.
-build-preview: check-deps check-go
+## Build site for local consumption
+build-preview: check-go check-deps
 	npm run build:preview
 
-## Local: Build and run site locally with draft and future content enabled.
-site: check-deps check-go
+## Build and run site locally with draft and future content enabled.
+site: check-go check-deps
 	npm run dev:site
 
-## Local: Run site locally in serve mode (without file watching).
-serve: check-deps check-go
+## Build and run site locally
+serve: check-go check-deps
 	npm run dev:serve
 
 ## Empty build cache and run on your local machine.
 clean:
 	npm run clean
-	$(MAKE) setup
-	$(MAKE) site
+
+## Format code using Prettier
+format:
+	npm run format
 
 ## Fix Markdown linting issues
 lint-fix:
-	@echo "Checking for markdownlint-cli2..."
-	@command -v markdownlint-cli2 > /dev/null || { \
-		echo "markdownlint-cli2 not found. Attempting to install globally..."; \
-		command -v npm > /dev/null || { echo "npm is not installed. Please install Node.js/npm and re-run 'make lint-fix'."; exit 1; }; \
-		npm install -g markdownlint-cli2; \
-	}
-	@echo "Running markdownlint-cli2 --fix..."
-	@markdownlint-cli2 --fix "**/*.md" "#node_modules" "#public" "#resources"
-
-## ------------------------------------------------------------
-----MAINTENANCE: Show help for available targets
-
-check-go:
-	@echo "Checking if Go is installed..."
-	@command -v go > /dev/null || (echo "Go is not installed. Please install it before proceeding."; exit 1)
-	@echo "Go is installed."
-
-## Update the academy-theme package to latest version
-theme-update: check-deps check-go
-	@echo "Updating to latest academy-theme..."
-	npm run update:theme
+	npm run lint:fix
 
-.PHONY: setup check-deps check-go build build-preview site serve clean lint-fix theme-update
+.PHONY: \
+	setup \
+	build \
+	build-preview \
+	serve \
+	site \
+	clean \
+	format \
+	lint-fix \
+	check-deps \
+	check-go \
+	theme-update