# Summary

[Introduction](./introduction.md)

[Architecture](./architecture.md)

[Quick Start](./quick-start.md)

[Getting Started](./getting-started.md)

---

- [Tutorial: Building CronJob](cronjob-tutorial/cronjob-tutorial.md)

  - [What's in a basic project?](./cronjob-tutorial/basic-project.md)
  - [Every journey needs a start, every program a main](./cronjob-tutorial/empty-main.md)
  - [Groups and Versions and Kinds, oh my!](./cronjob-tutorial/gvks.md)
  - [Adding a new API](./cronjob-tutorial/new-api.md)
  - [Designing an API](./cronjob-tutorial/api-design.md)

    - [A Brief Aside: What's the rest of this stuff?](./cronjob-tutorial/other-api-files.md)

  - [What's in a controller?](./cronjob-tutorial/controller-overview.md)
  - [Implementing a controller](./cronjob-tutorial/controller-implementation.md)

    - [You said something about main?](./cronjob-tutorial/main-revisited.md)

  - [Implementing defaulting/validating webhooks](./cronjob-tutorial/webhook-implementation.md)
  - [Running and deploying the controller](./cronjob-tutorial/running.md)

    - [Deploying cert-manager](./cronjob-tutorial/cert-manager.md)
    - [Deploying webhooks](./cronjob-tutorial/running-webhook.md)

  - [Writing tests](./cronjob-tutorial/writing-tests.md)

- [Tutorial: Multi-Version API](./multiversion-tutorial/tutorial.md)

  - [Changing things up](./multiversion-tutorial/api-changes.md)
  - [Hubs, spokes, and other wheel metaphors](./multiversion-tutorial/conversion-concepts.md)
  - [Implementing conversion](./multiversion-tutorial/conversion.md)

    - [and setting up the webhooks](./multiversion-tutorial/webhooks.md)

  - [Deployment and Testing](./multiversion-tutorial/deployment.md)

---

- [Migrations](./migrations.md)

  - [Manual Migration Process](./migration/manual-process.md)
    - [Using AI](./migration/ai-helpers.md)
      - [Step 1: Reorganize Layout](./migration/reorganize-layout.md)
      - [Step 2: Discovery Commands](./migration/discovery-commands.md)
      - [Step 3: Port Code](./migration/port-code.md)
  - [Single Group to Multi-Group](./migration/multi-group.md)
  - [Cluster-Scoped to Namespace-Scoped](./migration/namespace-scoped.md)

- [Alpha Commands](./reference/alpha_commands.md)

  - [alpha generate](./reference/commands/alpha_generate.md)
  - [alpha update](./reference/commands/alpha_update.md)

---

- [Reference](./reference/reference.md)

  - [Generating CRDs](./reference/generating-crd.md)
  - [Using Finalizers](./reference/using-finalizers.md)
  - [Good Practices](./reference/good-practices.md)
  - [Server-Side Apply](./reference/server-side-apply.md)
  - [License Header](./reference/license-header.md)
  - [Raising Events](./reference/raising-events.md)
  - [Watching Resources](./reference/watching-resources.md)
    - [Owned Resources](./reference/watching-resources/secondary-owned-resources.md)
    - [Not Owned Resources](./reference/watching-resources/secondary-resources-not-owned.md)
    - [Using Predicates](./reference/watching-resources/predicates-with-watch.md)
  - [Kind for Dev & CI](reference/kind.md)
  - [What's a webhook?](reference/webhook-overview.md)
    - [Admission webhook](reference/admission-webhook.md)
    - [Webhook bootstrap problem](reference/webhook-bootstrap-problem.md)
  - [Markers for Config/Code Generation](./reference/markers.md)

    - [CRD Generation](./reference/markers/crd.md)
    - [CRD Validation](./reference/markers/crd-validation.md)
    - [CRD Processing](./reference/markers/crd-processing.md)
    - [Webhook](./reference/markers/webhook.md)
    - [Object/DeepCopy](./reference/markers/object.md)
    - [Apply Configuration](./reference/markers/applyconfiguration.md)
    - [RBAC](./reference/markers/rbac.md)
    - [Scaffold](./reference/markers/scaffold.md)

  - [controller-gen CLI](./reference/controller-gen.md)
  - [completion](./reference/completion.md)
  - [Artifacts](./reference/artifacts.md)
  - [Platform Support](./reference/platform.md)
  - [Monitoring with Pprof](./reference/pprof-tutorial.md)

  - [Manager and CRDs Scope](./reference/scopes.md)
    - [Manager Scope](./reference/manager-scope.md)
    - [CRD Scope](./reference/crd-scope.md)

  - [Sub-Module Layouts](./reference/submodule-layouts.md)
  - [Using an external Resource / API](./reference/using_an_external_resource.md)
  - [Multiple Controllers Per Resource](./reference/multiple-controllers.md)

  - [Configuring EnvTest](./reference/envtest.md)

  - [Metrics](./reference/metrics.md)

    - [Reference](./reference/metrics-reference.md)

  - [Project config](./reference/project-config.md)
  - [Versions Compatibility and Supportability](./versions_compatibility_supportability.md)

---

- [Plugins][plugins]

  - [Available Plugins](./plugins/available-plugins.md)
    - [autoupdate/v1-alpha](./plugins/available/autoupdate-v1-alpha.md)
    - [deploy-image/v1-alpha](./plugins/available/deploy-image-plugin-v1-alpha.md)
    - [go/v4](./plugins/available/go-v4-plugin.md)
    - [grafana/v1-alpha](./plugins/available/grafana-v1-alpha.md)
    - [helm/v1-alpha](./plugins/available/helm-v1-alpha.md)
    - [helm/v2-alpha](./plugins/available/helm-v2-alpha.md)
    - [kustomize/v2](./plugins/available/kustomize-v2.md)
  - [Extending](./plugins/extending.md)
    - [CLI and Plugins](./plugins/extending/extending_cli_features_and_plugins.md)
    - [External Plugins](./plugins/extending/external-plugins.md)
    - [Custom Markers](./plugins/extending/custom-markers.md)
    - [E2E Tests](./plugins/extending/testing-plugins.md)
  - [Plugins Versioning](./plugins/plugins-versioning.md)


---

[FAQ](./faq.md)

[plugins]: ./plugins/plugins.md
