README.md

PTD Documentation

Welcome to the Posit Team Dedicated (PTD) documentation.

Quick Links

For Developers

• PTD CLI Reference - Complete CLI command documentation
• Adding Config Options - How to add new configuration options to Team Operator

Architecture

• Config Flow - How configuration flows from YAML through Go to Python
• Step Dependencies - The step execution pipeline and dependencies
• Pulumi Conventions - Pulumi-specific patterns and resource naming

For Operators

• Team Operator Overview - Understanding the Kubernetes operator
• Monitoring - The Grafana monitoring stack

Infrastructure

• Kubernetes Guide - Kubernetes-specific documentation

Misc

• Known Issues - Known issues and rough edges

Documentation Structure

docs/
├── architecture/           # Architecture documentation
├── cli/                    # PTD CLI documentation
├── team-operator/          # Team Operator documentation
├── guides/                 # How-to guides
└── infrastructure/         # Infrastructure documentation

Contributing

When adding new features:

1. Update relevant documentation in this structure
2. Use the /update-docs skill to identify which docs need updating
3. Keep examples up-to-date and runnable