chore: remove old Hugo docs generation (#856)

* chore: remove old Hugo doc publishing workflows

These workflows pushed the docs.kosli.com/ directory to docs-main and
staging-docs branches for Netlify Hugo builds. No longer needed now that
docs are generated via Mintlify in kosli-dev/docs.

Part of kosli-dev/docs#42

* chore: remove docs-gen job from release workflow, drop Hugo helm-docs output

- Remove the docs-gen job that generated CLI reference markdown and
  pushed docs.kosli.com/ to the docs-main branch on every release
- Remove the docs-gen dependency from the failure-notification job
- Remove the helm-docs line that wrote to docs.kosli.com/content/helm/

The docs-repo-dispatch job is kept — it notifies kosli-dev/docs of new
CLI releases so Mintlify can regenerate.

Part of kosli-dev/docs#42

* chore: remove old docs Makefile targets and scripts

Remove targets: cli-docs, legacy-ref-docs, generate-json-metadata,
hugo, hugo-local, test_docs, check-links, and the second helm-docs
output line that wrote to docs.kosli.com/.

Delete scripts:
- bin/test_docs_cmds.sh (tested commands embedded in Hugo markdown)
- hack/generate-old-versions-docs.sh (generated legacy version docs)

Part of kosli-dev/docs#42

* chore: remove docs.kosli.com/ Hugo site directory

Remove the entire Hugo documentation site (239 tracked files): config,
layouts, content, assets, static files, and Netlify config. Documentation
is now maintained in the kosli-dev/docs Mintlify repo.

Part of kosli-dev/docs#42

* chore: remove Hugo formatter, make Mintlify the default doc format

- Delete internal/docgen/hugo.go and hugo_test.go
- Remove --mintlify flag from `kosli docs` (Mintlify is now the only format)
- Update generate_test.go and formatter_test.go to use MintlifyFormatter
- Update docs_test.go to compare against Mintlify golden files
- Delete Hugo golden test fixtures (testdata/output/docs/hugo/)

Part of kosli-dev/docs#42

* chore: clean up remaining Hugo docs references

- Remove docs.kosli.com/ patterns from .gitignore
- Delete .clear-files (preserved Hugo-generated content during deploys)
- Delete .htmltest.yml (pointed at Hugo build output)
- Update README.md and dev-guide.md docs links
- Update release-guide.md: remove old docs generation/hosting sections,
  document Mintlify dispatch workflow

Closes kosli-dev/docs#42

* chore: mark docs cleanup slices as complete in TODO.md

Author: dangrondahl

.clear-files

@@ -50,7 +50,6 @@ jobs:
         run: |
           cd charts/k8s-reporter
           helm-docs --template-files README.md.gotmpl,_templates.gotmpl --output-file README.md
-          helm-docs --template-files README.md.gotmpl,_templates.gotmpl --output-file ../../docs.kosli.com/content/helm/_index.md
 
       - name: Helm Package
         run: helm package charts/k8s-reporter --destination package

.github/workflows/helm-chart.yml

@@ -244,48 +244,6 @@ jobs:
           # the personal access token should have "repo" & "workflow" scopes
           COMMITTER_TOKEN: ${{ secrets.COMMITTER_TOKEN }}
 
-  docs-gen:
-    needs: [goreleaser, pre-build]
-    runs-on: ubuntu-latest
-    steps:
-      - name: Harden Runner
-        uses: step-security/harden-runner@8d3c67de8e2fe68ef647c8db1e6a09f647780f40 # v2.19.0
-        with:
-          egress-policy: audit
-
-      - name: Checkout
-        uses: actions/checkout@v6
-        with:
-          fetch-depth: 0 # needed to be able to generate legacy versions reference.
-
-      - name: Set up Go
-        uses: actions/setup-go@v6
-        with:
-          go-version-file: '.go-version'
-          check-latest: true
-
-      - name: Generate docs
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        # legacy-ref should happen first as it has the side effect of deleting generated files outside the legacy_ref
-        run: |
-          make legacy-ref-docs
-          make cli-docs
-
-      - name: Generate json
-        run: |
-          echo '{"currentversion": "${{ needs.pre-build.outputs.tag }}"}' > docs.kosli.com/assets/metadata.json
-
-      - name: Deploy
-        uses: s0/git-publish-subdir-action@develop
-        env:
-          REPO: self
-          BRANCH: docs-main
-          FOLDER: docs.kosli.com
-          TARGET_DIR: docs.kosli.com
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          MESSAGE: "Release: {msg}"
-
   docs-repo-dispatch:
     needs: [pre-build, goreleaser]
     runs-on: ubuntu-latest
@@ -360,7 +318,6 @@ jobs:
         goreleaser,
         binary-provenance,
         homebrew-pr,
-        docs-gen,
         docs-repo-dispatch,
         evidence-reporter-upload-package-and-deploy,
         environment-reporter-upload-package-and-deploy,

.github/workflows/publish_branch_docs.yml

@@ -12,18 +12,11 @@ coverage.html
 licenses/
 **/.DS_Store
 .vscode/
-/docs/public
-docs.kosli.com/resources/_gen/*
-docs.kosli.com/content/client_reference/kosli*
-docs.kosli.com/public/
-docs.kosli.com/.netlify
 npm/cli*/bin/*
 npm/*/kosli*.tgz
 *.tar.gz
 *~
 /.idea
-# keep it uncommented on main
-docs.kosli.com/assets/metadata.json
 tmp/
 release_notes.md
 junit.xml

.github/workflows/publish_docs.yml

@@ -1,4 +1,4 @@
-.PHONY: help build clean clean-cache deps fmt lint vet docker ldflags ensure_golangci-lint check_dirty add_test_tag build_release ensure_network ensure_gotestsum test_setup test_integration test_integration_full test_integration_single test_docs cli-docs licenses upgrade-deps hugo hugo-local helm-lint helm-docs release check-links suggest-version-ai
+.PHONY: help build clean clean-cache deps fmt lint vet docker ldflags ensure_golangci-lint check_dirty add_test_tag build_release ensure_network ensure_gotestsum test_setup test_integration test_integration_full test_integration_single licenses upgrade-deps helm-lint helm-docs release suggest-version-ai
 .DEFAULT: help
 .DEFAULT_GOAL := help
 .DELETE_ON_ERROR:
@@ -157,9 +157,6 @@ test_contract_github: ensure_gotestsum ## Run GitHub contract tests against real
 test_contract: test_contract_aws test_contract_github ## Run all contract tests against real external services
 
 
-test_docs: deps vet ensure_network test_setup ## Test docs
-	./bin/test_docs_cmds.sh docs.kosli.com/content/use_cases/simulating_a_devops_system/_index.md
-
 logs_integration_test_server:
 	@docker logs cli_kosli_server ${CONTAINER} 2>&1
 
@@ -172,13 +169,6 @@ enter_integration_test_server:
 docker: ## Build CLI Docker image
 	@docker build -t kosli-cli .
 
-cli-docs: build ## Generate docs
-	@rm -f docs.kosli.com/content/client_reference/kosli*
-	@export DOCS=true && ./$(BIN) docs --dir docs.kosli.com/content/client_reference
-
-legacy-ref-docs:
-	@./hack/generate-old-versions-docs.sh "v2.*"
-
 licenses: ## Update licenses
 	@rm -rf licenses || true
 	@go install github.com/google/go-licenses@latest
@@ -189,23 +179,13 @@ licenses: ## Update licenses
 upgrade-deps: ## Update Go dependencies
 	@go get -u ./...
 
-generate-json-metadata: ## Generate docs metadata
-	echo '{"currentversion": "vlocal"}' > docs.kosli.com/assets/metadata.json
-
-hugo: cli-docs helm-docs generate-json-metadata ## Run docs locally
-	cd docs.kosli.com && hugo server --minify --buildDrafts --port=1515
-
-hugo-local: cli-docs generate-json-metadata
-	cd docs.kosli.com && hugo server --minify --buildDrafts --port=1515
-
 helm-lint: ## Lint Helm chart
 	@cd charts/k8s-reporter && helm lint . \
 		--set reporterConfig.kosliOrg=placeholder \
 		--set 'reporterConfig.environments[0].name=placeholder'
 
 helm-docs: helm-lint ## Update Helm docs
 	@cd charts/k8s-reporter &&  docker run --rm --volume "$(PWD):/helm-docs" jnorwood/helm-docs:latest --template-files README.md.gotmpl,_templates.gotmpl --output-file README.md
-	@cd charts/k8s-reporter &&  docker run --rm --volume "$(PWD):/helm-docs" jnorwood/helm-docs:latest --template-files README.md.gotmpl,_templates.gotmpl --output-file ../../docs.kosli.com/content/helm/_index.md
 
 # Suggest next semver and changelog using Claude.
 # Writes changelog to dist/release_notes.md for use with goreleaser --release-notes.
@@ -236,10 +216,3 @@ release: ## Cut a new release and push next tag
 	  ([ -f dist/release_notes.md ] && git tag -a $(tag) -F dist/release_notes.md) || git tag -a $(tag) -m"$(tag)"; \
 	  git push origin $(tag); \
 	fi
-
-# check-links:
-# 	@docker run -v ${PWD}:/tmp:ro --rm -i --entrypoint '' ghcr.io/tcort/markdown-link-check:stable /bin/sh -c 'find /tmp/docs.kosli.com/content -name \*.md -print0 | xargs -0 -n1 markdown-link-check -q -c /tmp/link-checker-config.json'
-
-check-links: ## Run html test for dead links
-	@cd docs.kosli.com && hugo --minify
-	@docker run -v ${PWD}:/test --rm wjdp/htmltest -c .htmltest.yml -l 1

.github/workflows/release.yml

@@ -7,7 +7,7 @@ This repo contains the Kosli CLI, for recording and querying software delivery e
 
 Some useful links: 
 
-* [Documentation site](https://docs.kosli.com/client_reference/) for full details on usage.
+* [Documentation site](https://docs.kosli.com/) for full details on usage.
 * [Developer guide](/dev-guide.md) for details on working with the code in this repo.
 * [Kosli main Trails](https://app.kosli.com/kosli-public/flows/cli/trails/)
 * [Kosli release Trails](https://app.kosli.com/kosli-public/flows/cli-release/trails/)

.gitignore

@@ -3,6 +3,15 @@
 <!-- Each feature gets its own ## section below. -->
 <!-- Only edit YOUR feature's section. Delete it after merging to main. -->
 
+## Clean up old docs generation (kosli-dev/docs#42)
+
+- [x] Slice 1: Remove old doc workflows (`publish_docs.yml`, `publish_branch_docs.yml`)
+- [x] Slice 2: Remove `docs-gen` job from `release.yml` + helm-chart.yml docs.kosli.com line
+- [x] Slice 3: Remove Makefile targets + scripts (`bin/test_docs_cmds.sh`, `hack/generate-old-versions-docs.sh`)
+- [x] Slice 4: Remove `docs.kosli.com/` directory
+- [x] Slice 5: Remove Hugo formatter (`internal/docgen/hugo.go`, `hugo_test.go`), update `docs.go` default
+- [x] Slice 6: Clean up references (`.gitignore`, `.clear-files`, `.htmltest.yml`, README, dev-guide, release-guide) — closes kosli-dev/docs#42
+
 ## Fix: git worktree HEAD resolution
 
 - [x] Slice 1: Enable `EnableDotGitCommonDir` in `gitview.New()` so HEAD resolves in worktrees