Guide to writing a composition

[negz]

What's Missing?

We have getting started guides but they just say "use this composition". We also have composition docs, but they're more of a reference and explaining the general concepts. It'd be neat to have a page walking you though writing your first composition.

Ideally without picking any one language. Maybe a lang selector to let you pick one of a few examples ala the other getting started guides.

This could help with how to think about compositions in general - e.g. the fact that you're really writing a chunk of a reconcile loop.

[vibe]

This could help with how to think about compositions in general - e.g. the fact that you're really writing a chunk of a reconcile loop.

---

Communicating that idea has been a challenge for me. I often run into engineers familiar with Kubernetes controllers/operators, and they tend to collapse the conventions of a full operator reconcile loop into composition step/function concepts, making it harder to reason that each step is really just a small "specialized" slice of the larger reconcile process.

Working on a few things on my end but if this stays open long enough, I'll try to give the documentation a pass.

[HighonAces]

Perhaps a practical use of where and how observed and desired state can be used.