You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 7a0e89e
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: CLAUDE.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
4
4
5
5
## Project Overview
6
6
7
-
Hugo documentation website for Cozystack (Kubernetes-based cloud platform) using the Google Docsy theme. **Production is served by GitHub Pages** — Netlify is only used for deploy previews on PRs. Do not rely on Netlify-specific features (`netlify.toml` redirects, headers, edge functions) for production behavior; they only work in deploy previews. For redirects, use Hugo aliases (per-page) or the JS fallback in `layouts/404.html`.
7
+
Hugo documentation website for Cozystack (Kubernetes-based cloud platform) using the Google Docsy theme. **Production is served by GitHub Pages**. Netlify is only used for deploy previews on PRs. Do not rely on Netlify-specific redirects or headers for production behavior. The stable `/docs/` and `/docs/v<major>/` paths are real copies of the latest version, produced after `hugo` by `hack/mirror_latest.sh` (Python 3 standard library). Current numbered docs and both copies use canonical URLs under `/docs/`. Older numbered docs remain noindex and are excluded from sitemaps. Preview builds are noindex. The version-selection landing is copied to `/docs/versions/`; mirroring preserves numbered versions and unrelated legacy aliases. The `.docs-mirror.json` file tracks root and major copies for cleanup on repeat builds. Under `hugo server`, version-selection links use the existing `/docs/` landing.
8
8
9
9
## Build & Development Commands
10
10
@@ -16,7 +16,7 @@ npm install
16
16
make serve
17
17
18
18
# Production build
19
-
./hack/download_openapi.sh && hugo --gc --minify
19
+
./hack/download_openapi.sh && hugo --gc --minify && ./hack/mirror_latest.sh
20
20
21
21
# Sync app docs from cozystack/cozystack repo.
22
22
# By default targets content/en/docs/next/ (the version-agnostic trunk).
@@ -66,7 +66,7 @@ Docs are versioned per Cozystack minor release. Each version is an independent c
66
66
- One directory per minor version: `content/en/docs/v0/`, `v1.0/`, `v1.1/`, `v1.2/`
67
67
- Version name derivation: major `0` → `v0` (legacy, covers all 0.x); major ≥ 1 → `v<major>.<minor>` (e.g., `v1.2`). Patch level is not reflected in the directory name
68
68
- Each version directory is self-contained: all pages under `applications/`, `virtualization/`, `networking/`, `operations/`, `storage/`, `install/`, `guides/`, etc. live once per version
69
-
- `content/en/docs/_index.md` is the single version-agnostic landing page
69
+
- `content/en/docs/_index.md` is the version-selection landing, published at `/docs/versions/` after mirroring
70
70
- `content/en/docs/next/` is the permanent trunk for upcoming/unreleased docs. Internal links use `/docs/next/`; these are rewritten at release time by `hack/release_next.sh`. Excluded from production builds via the `hidden: true` entry in `hugo.yaml` and the content mount exclusion `- '! docs/next/**'`
0 commit comments