What do you find confusing about Salt on Qubes OS?

Things like this really hurt… I spent a lot of time trying to understand the disconnects between Qubes salt and the upstream docs. “top” does seem to exist in plain salt here but doesn’t match somehow.

I feel like there are multiple terms for every concept…

I got some good help in this thread , but I still have problems with the different docs (although I did make a little progress).

Here’s an example… In the qubes salt docs there is this:

In Qubes, we don’t have a master. Instead we have one minion which resides in dom0 and manages qubes from there.

I can get that - but then later there is this:

The target_matching_clause will be used to select your minions (Templates or qubes)

…and there I am, lost and fumbling around in the dark. What is it: one minion, multiple ones, one which can create its own sub-minions, one which creates its peer minions?

As a concrete suggestion, instead of yet more explanation with embedded fragments of sls/top files, maybe it would be useful to have a single, giant, and verbosely self documented, setup to create and maintain a small set of demo qubes.