docs-taxonomy.yml

collections:
  case:
    path: cases
    title: 트러블슈팅
    description: 느린 응답, 막힌 I/O, 예상과 다른 동작. 관측한 증상에서 시작해 원인 후보를 하나씩 좁혀 간 기록입니다.
    statuses: [unresolved, resolved, historical]
    required_fields: [occurred_at]
  guide:
    path: guides
    title: 구현 가이드
    description: 구성을 연결하고 동작을 확인하는 데 필요한 절차를 정리했습니다. 내 환경에 맞는 전제와 적용 범위부터 살펴보세요.
    statuses: [current, needs-review, deprecated]
    required_fields: [last_verified, review_cycle_days, applies_to]
  lab:
    path: labs
    title: 실습
    description: 읽는 데서 끝내지 않고 직접 재현합니다. 배포할 구성, 확인할 결과, 비용과 정리 절차를 함께 살펴보세요.
    statuses: [verified, needs-review, broken, archived]
    required_fields: [last_verified, review_cycle_days, estimated_time, cost, cleanup_required]
  research:
    path: research
    title: 비교·분석
    description: 어떤 선택이 더 나은지는 조건에 따라 달라집니다. 처리량과 비용, 품질과 복잡도를 비교하고 판단의 근거를 남깁니다.
    statuses: [current, superseded, archived]
    required_fields: [published_at]

services:
  application-development: Application Development
  azure-application-gateway: Azure Application Gateway
  azure-application-gateway-for-containers: Azure Application Gateway for Containers
  azure-ai-search: Azure AI Search
  azure-api-management: Azure API Management
  azure-app-service: Azure App Service
  azure-architecture: Azure Architecture
  azure-automation: Azure Automation
  azure-container-apps: Azure Container Apps
  azure-cosmos-db: Azure Cosmos DB
  azure-database-for-mysql: Azure Database for MySQL
  azure-functions: Azure Functions
  azure-front-door: Azure Front Door
  azure-hdinsight: Azure HDInsight
  azure-kubernetes-service: Azure Kubernetes Service
  azure-load-testing: Azure Load Testing
  azure-managed-redis: Azure Managed Redis
  azure-monitor: Azure Monitor
  azure-openai: Azure OpenAI
  azure-storage: Azure Storage
  microsoft-entra-id: Microsoft Entra ID
  microsoft-foundry: Microsoft Foundry

technologies:
  azure-cli: Azure CLI
  bicep: Bicep
  cosmos-db: Azure Cosmos DB
  docker: Docker
  dotnet: .NET
  gitops: GitOps
  go: Go
  grafana: Grafana
  java: Java
  kafka: Apache Kafka
  kubernetes: Kubernetes
  mcp: Model Context Protocol
  mysql: MySQL
  nodejs: Node.js
  open-telemetry: OpenTelemetry
  powershell: PowerShell
  prometheus: Prometheus
  python: Python
  rag: Retrieval-augmented generation
  redis: Redis
  rest-api: REST API

tags:
  design: 설계
  build: 구현
  deploy: 배포
  diagnose: 진단
  optimize: 최적화
  operate: 운영
  secure: 보안
  evaluate: 비교·검증
  migrate: 마이그레이션
  ai-agents: AI agents
  networking: 네트워킹
  identity: ID·권한
  storage: 스토리지

tag_groups:
  goal:
    label: 목적
    tags: [design, build, deploy, diagnose, optimize, operate, secure, evaluate, migrate]
  subject:
    label: 주제
    tags: [ai-agents, networking, identity, storage]

legacy_tag_redirects:
  ai-agents: {tag: [ai-agents]}
  architecture: {tag: [design]}
  authentication: {tag: [identity, secure]}
  authorization: {tag: [identity, secure]}
  benchmarking: {tag: [evaluate]}
  deployment: {tag: [deploy]}
  development: {tag: [build]}
  diagnostics: {tag: [diagnose]}
  troubleshooting: {tag: [diagnose]}
  disaster-recovery: {tag: [operate]}
  high-availability: {tag: [operate]}
  monitoring: {tag: [operate]}
  observability: {tag: [operate]}
  reliability: {tag: [operate]}
  kubernetes: {technology: [kubernetes]}
  latency: {tag: [optimize]}
  performance: {tag: [optimize]}
  migration: {tag: [migrate]}
  networking: {tag: [networking]}
  security: {tag: [secure]}
  storage: {tag: [storage]}

verification_statuses: [verified, needs-review]
required_source_host: learn.microsoft.com
official_source_hosts:
  - learn.microsoft.com
  - www.copilotkit.ai
  - docs.copilotkit.ai
  - docs.ag-ui.com
  - dojo.ag-ui.com
  - a2ui.org
  - generativeui.github.io
  - blog.google
  - openjdk.org
  - kubernetes.io
  - www.cncf.io
  - cncf.io
  - github.com
  - modelcontextprotocol.io
  - py.sdk.modelcontextprotocol.io
  - prices.azure.com
  - www.rfc-editor.org