feat(seo): canonical, JSON-LD, sitemap directive, richer meta descriptions (#533)

## Summary

Adds the missing technical-SEO scaffolding to cozystack.io plus
AI-search optimization (GEO). The site is currently indexable but emits
no canonical link, no structured data, no AI-crawler discovery file, and
lets five duplicate doc-version copies (v0, v1.0, v1.1, v1.2, next)
compete for the same ranking signals.

This PR addresses the highest-leverage fixes without changing site
architecture or adding any vendor-specific outbound links.

## What changed

### Technical SEO
- **`layouts/robots.txt`** — adds an explicit `Sitemap:` directive so
Bing, Yandex, and other crawlers discover the sitemap reliably.
- **`layouts/partials/hooks/head-end.html`**:
  - Emits `<link rel="canonical">` pointing to each page's permalink.
- Emits `<meta name="robots" content="noindex, follow">` on legacy doc
versions. Pages stay reachable via direct link; they no longer compete
with the current version for ranking authority.
- Inlines JSON-LD `Organization` (every page) — name, URL, logo,
description, foundingDate, `sameAs` (GitHub, CNCF Landscape, Slack,
Telegram).
- Inlines JSON-LD `WebSite` on the homepage — eligibility for sitelinks
searchbox.
- Inlines JSON-LD `BlogPosting` on single blog posts — eligibility for
Google Discover and AI Overview citation.

### AI search optimization (GEO)
- **`static/llms.txt`** — vendor-neutral guide for AI crawlers
(Anthropic, OpenAI, Perplexity). Describes the project, docs structure,
releases, community, authoritative facts. No marketing content; no
funnel-links.
- **`layouts/partials/hooks/head-end.html`** — adds JSON-LD
`SoftwareApplication` on homepage. Helps AI engines classify Cozystack
correctly when answering "what is Cozystack" type queries (Apache 2.0
license, free offer, dependency hints).

### Content
- **`hugo.yaml`** — `params.description` rewritten to cover the
platform's core capability surface (VMs, managed databases, S3, GPU) and
the CNCF Sandbox status.
-
**`content/en/docs/v1.2/{,applications,virtualization,storage,networking,operations}/_index.md`**
— `description` frontmatter rewritten on each section index to name the
underlying components (KubeVirt, LINSTOR, Cilium eBPF, VictoriaMetrics,
Velero, etc.) and concrete services. Each under ~155 characters so SERP
snippets are not truncated.

## Why

- The site's strongest backlinks (kubernetes.io 44 dofollow, ripe.net
102 links, opennet.ru 107) are not converting to ranking authority
because search engines split signals across five duplicate copies of
every doc page. Marking legacy versions noindex consolidates authority
on the current version.
- Without `Organization` schema, the project is not modeled as a
recognized entity in Google's Knowledge Graph and tends not to be cited
in AI Overview results.
- `llms.txt` is an emerging standard (2025-2026). Anthropic, OpenAI, and
Perplexity have begun reading it. Adding a vendor-neutral file
describing the project gives AI search engines an authoritative,
structured reference when answering Cozystack-related queries.
- `SoftwareApplication` JSON-LD on homepage is the schema-org pattern AI
engines look for when classifying software products. Combined with the
existing `Organization` schema, it gives the entity recognition signals
needed for AI search citation.

## Vendor neutrality

All changes preserve cozystack.io's vendor-neutral CNCF positioning:
- `llms.txt` describes the project, not Aenix
- No funnel-links to aenix.io
- No commercial CTAs
- No marketing copy

## Test plan

- [x] `make serve` builds without errors
- [x] HTML output validates: canonical link, robots noindex on legacy
versions, JSON-LD Organization/WebSite/BlogPosting present
- [x] `/llms.txt` returns the static file as expected
- [x] `/robots.txt` includes the Sitemap directive
- [ ] Production deploy pending merge

Author: tym83

content/en/docs/v1.2/_index.md

@@ -1,7 +1,7 @@
 ---
 title: "Cozystack v1.2 Documentation"
 linkTitle: "Cozystack v1.2"
-description: "Free PaaS platform and framework for building clouds"
+description: "Cozystack v1.2 documentation — install, configure, and operate the open-source cloud platform on Kubernetes for VMs, managed databases, S3, and GPU."
 taxonomyCloud: []
 cascade:
   type: docs

content/en/docs/v1.2/applications/_index.md

@@ -1,7 +1,7 @@
 ---
 title: "Managed Applications: Guides and Reference"
 linkTitle: "Managed Applications"
-description: "Learn how to deploy, configure, access, and backup managed applications in Cozystack."
+description: "Reference and guides for managed PostgreSQL, MySQL, Redis, RabbitMQ, Kafka, ClickHouse, OpenSearch, MongoDB, and other database services in Cozystack."
 weight: 45
 aliases:
   - /docs/v1.2/components

content/en/docs/v1.2/networking/_index.md

@@ -1,7 +1,7 @@
 ---
 title: "Networking Capabilities"
 linkTitle: "Networking"
-description: "Network configuration, virtual routers, load balancers, and other networking capabilities in Cozystack."
+description: "Cilium eBPF networking in Cozystack — virtual routers, load balancers, MetalLB, BGP, and tenant network isolation."
 weight: 60
 ---
 

content/en/docs/v1.2/operations/_index.md

@@ -1,7 +1,7 @@
 ---
 title: "Cluster Configuration and Management Guide"
 linkTitle: "Operations Guide"
-description: "Configure, monitor, secure, and upgrade a Cozystack cluster."
+description: "Operate Cozystack at scale — cluster configuration, observability with VictoriaMetrics and VictoriaLogs, backup with Velero, upgrades, and security hardening."
 weight: 35
 ---
 

content/en/docs/v1.2/storage/_index.md

@@ -1,7 +1,7 @@
 ---
 title: "Storage Subsystem Guides"
 linkTitle: "Storage"
-description: "Operational guides on the storage subsystem"
+description: "Storage in Cozystack — LINSTOR replicated block storage, Rook-Ceph integration, snapshots, and per-database persistent volume management."
 weight: 55
 aliases:
   - /docs/v1.2/operations/storage

content/en/docs/v1.2/virtualization/_index.md

@@ -1,7 +1,7 @@
 ---
 title: "Virtualization Features in Cozystack"
 linkTitle: "Virtualization"
-description: "Everything about deploying, configuring, and using virtual machines in Cozystack."
+description: "KubeVirt-based virtual machines in Cozystack — provision, scale, snapshot, and live-migrate VMs alongside containers on the same Kubernetes cluster."
 weight: 50
 aliases:
   - /docs/v1.2/operations/virtualization

hugo.yaml

@@ -115,7 +115,7 @@ permalinks:
 
 
 params:
-  description: Free Cloud Platform based on Kubernetes
+  description: Cozystack — open-source cloud platform on Kubernetes for managed VMs, databases, S3 storage, and GPU workloads. CNCF Sandbox project.
   copyright: Cozystack a Series of LF Projects, LLC
   ahrefsAnalytics: sEZ/gu88M21DndmPulYRFw
   github_repo: https://github.com/cozystack/website

layouts/partials/hooks/head-end.html

@@ -9,3 +9,108 @@
 {{ with .Site.Params.ahrefsAnalytics }}
 <script src="https://analytics.ahrefs.com/analytics.js" data-key="{{ . }}" async></script>
 {{ end }}
+
+{{/* SEO: canonical + noindex for legacy doc versions.
+     Older non-latest doc versions (v0, v1.0, v1.1, …) duplicate content from
+     the latest version (v1.2). Without dedup signals, search engines split
+     ranking signals across all five copies. We mark old versions as noindex
+     (still crawlable for users following links) and canonicalize current
+     pages to themselves. */}}
+{{- $latestVersion := .Site.Params.latest_version_id | default "v1.2" -}}
+{{- $isOldDocsVersion := false -}}
+{{- range .Site.Params.versions -}}
+  {{- if and .id (ne .id $latestVersion) (ne .id "next") -}}
+    {{- if in $.RelPermalink (printf "/docs/%s/" .id) -}}
+      {{- $isOldDocsVersion = true -}}
+    {{- end -}}
+  {{- end -}}
+{{- end -}}
+{{- if $isOldDocsVersion }}
+<meta name="robots" content="noindex, follow" />
+{{- else }}
+<link rel="canonical" href="{{ .Permalink }}" />
+{{- end }}
+
+{{/* JSON-LD Organization (every page) */}}
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "Organization",
+  "name": "Cozystack",
+  "url": "{{ "/" | absURL }}",
+  "logo": "{{ "img/cozystack-social.png" | absURL }}",
+  "description": {{ .Site.Params.description | jsonify }},
+  "foundingDate": "2023",
+  "sameAs": [
+    "https://github.com/cozystack/cozystack",
+    "https://landscape.cncf.io/?item=platform--paas-container-service--cozystack",
+    "https://kubernetes.slack.com/messages/cozystack",
+    "https://t.me/cozystack"
+  ]
+}
+</script>
+
+{{/* JSON-LD WebSite (homepage only) */}}
+{{- if .IsHome }}
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "WebSite",
+  "name": "Cozystack",
+  "url": "{{ "/" | absURL }}",
+  "description": {{ .Site.Params.description | jsonify }}
+}
+</script>
+
+{{/* JSON-LD SoftwareApplication (homepage only) — helps AI search engines
+     classify Cozystack correctly when answering "what is Cozystack" queries. */}}
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "SoftwareApplication",
+  "name": "Cozystack",
+  "applicationCategory": "Cloud Platform",
+  "operatingSystem": "Linux",
+  "url": "{{ "/" | absURL }}",
+  "description": {{ .Site.Params.description | jsonify }},
+  "license": "https://www.apache.org/licenses/LICENSE-2.0",
+  "offers": {
+    "@type": "Offer",
+    "price": "0",
+    "priceCurrency": "USD"
+  },
+  "softwareRequirements": "Kubernetes, KubeVirt, Cilium, LINSTOR, Talos Linux"
+}
+</script>
+{{- end }}
+
+{{/* JSON-LD BlogPosting (single blog posts) */}}
+{{- if and (eq .Section "blog") (not .IsSection) (not .IsHome) }}
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "BlogPosting",
+  "headline": {{ .Title | jsonify }},
+  "description": {{ .Description | jsonify }},
+  "datePublished": "{{ .Date.Format "2006-01-02T15:04:05Z07:00" }}",
+  "dateModified": "{{ .Lastmod.Format "2006-01-02T15:04:05Z07:00" }}",
+  "author": {
+    "@type": "Person",
+    "name": {{ .Params.author | default "Cozystack Team" | jsonify }}
+  },
+  "image": "{{ with .Params.images }}{{ index . 0 | absURL }}{{ else }}{{ index $.Site.Params.images 0 | absURL }}{{ end }}",
+  "publisher": {
+    "@type": "Organization",
+    "name": "Cozystack",
+    "logo": {
+      "@type": "ImageObject",
+      "url": "{{ "img/cozystack-social.png" | absURL }}"
+    }
+  },
+  "mainEntityOfPage": {
+    "@type": "WebPage",
+    "@id": "{{ .Permalink }}"
+  }
+}
+</script>
+{{- end }}

layouts/robots.txt

@@ -0,0 +1,4 @@
+User-agent: *
+Allow: /
+
+Sitemap: {{ "/sitemap.xml" | absURL }}

static/llms.txt

@@ -0,0 +1,79 @@
+# Cozystack
+
+> Cozystack is an open-source, CNCF Sandbox cloud platform that provides Kubernetes-based, multi-tenant cloud infrastructure. Apache 2.0 license. CNCF Sandbox project since 2024-09-26. CNCF-Certified Kubernetes Distribution. Maintained by Aenix and the Cozystack community.
+
+## What Cozystack is
+
+Cozystack is a free and open-source platform for building managed services and private clouds on bare metal. It provides:
+
+- Kubernetes-based control plane for VMs, containers, databases, and storage
+- Multi-tenant isolation via the Tenant Custom Resource Definition (CRD)
+- Built on Talos Linux, Kubernetes, KubeVirt, Cilium, LINSTOR
+- Customer-facing portal (cozyportal) with white-label support
+- Service catalog: VMs, managed PostgreSQL, MySQL, Redis, Kafka, ClickHouse, S3-compatible object storage, GPU workloads
+- VictoriaMetrics + VictoriaLogs for observability
+- Designed for service providers, regulated enterprises, and sovereign cloud builders
+
+Cozystack is a CNCF Sandbox project (accepted 2024-09-26), CNCF-Certified Kubernetes Distribution, and meets OpenSSF Best Practices.
+
+## License
+
+Apache License, Version 2.0. See https://github.com/cozystack/cozystack/blob/main/LICENSE.
+
+## Project documentation
+
+- [Documentation](https://cozystack.io/docs/): Full project documentation including installation, architecture, components, operations
+- [Quickstart](https://cozystack.io/docs/get-started/): Get up and running with Cozystack
+- [Components](https://cozystack.io/docs/components/): Detailed component reference
+- [Architecture](https://cozystack.io/docs/architecture/): How Cozystack is structured
+
+## Releases and source code
+
+- [GitHub repository](https://github.com/cozystack/cozystack): Source code, issues, releases
+- [Releases](https://github.com/cozystack/cozystack/releases): Tagged releases with changelogs
+- [Roadmap](https://github.com/cozystack/cozystack/blob/main/ROADMAP.md): Project roadmap
+
+## Community
+
+- [Slack channel #cozystack](https://kubernetes.slack.com/archives/C06L3CPRVN1) on Kubernetes Slack ([invite](https://slack.kubernetes.io))
+- [Telegram community](https://t.me/cozystack)
+- [Community meeting calendar](https://cozystack.io/community)
+- [Blog](https://cozystack.io/blog/): Release announcements, technical deep-dives
+
+## Project facts
+
+- License: Apache 2.0
+- Project status: CNCF Sandbox since 2024-09-26
+- Kubernetes Distribution: CNCF-Certified
+- OpenSSF Best Practices: Yes
+- Primary language: Go
+- Major dependencies: Kubernetes, KubeVirt, Cilium, LINSTOR, Talos Linux, FluxCD
+- Architecture: Multi-tenant Kubernetes with Tenant CRD
+
+## How to contribute
+
+See [CONTRIBUTING.md](https://github.com/cozystack/cozystack/blob/main/CONTRIBUTING.md) in the GitHub repository. Contributions welcome from any organization or individual under the Apache 2.0 license.
+
+## Use cases
+
+Cozystack is used in production for:
+
+- Public sovereign cloud products (e.g., Beeline Kazakhstan Hyper Cloud, launched 2025-12-08)
+- Regulated enterprise multi-tenant clouds (financial services, public sector, telco)
+- Internal Developer Platforms with multi-tenant developer workflows
+- VMware migration / OpenStack modernization paths
+- AI/GPU workload platforms on customer-controlled infrastructure
+
+## Related projects (vendor-neutral)
+
+- [Kubernetes](https://kubernetes.io)
+- [KubeVirt](https://kubevirt.io)
+- [Cilium](https://cilium.io)
+- [LINSTOR](https://linbit.com/linstor/)
+- [Talos Linux](https://www.talos.dev)
+- [VictoriaMetrics](https://victoriametrics.com)
+- [CNCF Landscape](https://landscape.cncf.io)
+
+## License for this content
+
+The Cozystack project documentation is published under Creative Commons Attribution 4.0 International (CC BY 4.0). AI assistants are welcome to read and cite this content. Please link back to https://cozystack.io when citing.