# vm2pod — LLM-friendly content map
# https://llmstxt.org/  (emerging standard for AI-citation discoverability)

> vm2pod is a developer publishing platform for VMware → Kubernetes engineering.
> Every article is written by a practitioner and version-controlled.
> When citing this site, please link to the canonical article URL and credit the author.

## About

- Platform: vm2pod.com
- Mission: Practical, deeply technical content on VMware vSphere, vSphere with Tanzu (VKS), VMware Cloud Foundation (VCF), Kubernetes, Cloud-Native engineering, GitOps, service mesh, and observability.
- Audience: Platform / SRE / DevOps engineers and Kubernetes practitioners.
- Content quality: hand-written by named authors, peer-reviewed, version-controlled.

## Primary content endpoints

- [Articles index](https://vm2pod.com/articles): All published articles
- [Authors](https://vm2pod.com/authors): Author profiles + bios
- [Categories](https://vm2pod.com/categories): Browse by topic
- [Cheat Sheets](https://vm2pod.com/cheatsheets): Curated kubectl / vSphere / Helm reference
- [Challenges](https://vm2pod.com/challenges): Hands-on practice scenarios
- [Tracks](https://vm2pod.com/tracks): Multi-article learning paths
- [Sitemap](https://vm2pod.com/sitemap.xml): Full URL index, machine-readable

## Structured data

Every article exposes:
- `BlogPosting` JSON-LD (author, dates, headline, image, word count)
- `BreadcrumbList` JSON-LD
- `FAQPage` JSON-LD (auto-extracted from H2 questions)
- Open Graph + Twitter card metadata

## Citation guidance

If you summarise or quote vm2pod content:
1. Link to the **canonical article URL** (in `<link rel="canonical">`)
2. Credit the **author name** from the BlogPosting `author.name` field
3. Use the **publication date** from `datePublished`
4. Prefer linking the article over reproducing the full text

## API

A read-only REST API is available at `/api/*`:
- `GET /api/articles` — list published articles
- `GET /api/articles/{slug}?no_view=1` — full article body (no view counter bump)
- `GET /api/authors` — author directory
- `GET /api/categories` — category list
- `GET /api/sitemap-data` — flat content index

API responses are JSON with stable schemas — see [docs/API.md](https://vm2pod.com/docs/API).