Improve rule sets documentation

I don't know how rule sets work, but this probably has to do with the documentation. :)

Perhaps a video would help people with this complex feature.

> I thought from reading the documentation that when I create new rule sets I should be able to use them as "actions" with Triggers

No, you get only a rules action.

Mapping actions back to core actions might be a nice feature though - in particular for rule sets, as you could wrap any rules into an action.

i am also puzzled with how rule sets work, but i think that they show up on the rule actions only if the claimed variable (the one defined upon rule set creation) is available at that time.
very confusing...
Vasilis

If your rule set depends on a specific thing, like a node or a user it will not appear as an action if that object is not present in your rule.

So, easiest way to solve that is to load a node or load a user by id in your rule and then any rule sets needing nodes or users will appear

Documentation is available in a link on the project page.

I was also completely confused by the rulesets explanation. It didn't even sound like it made sense. I will figure it out, but not from the documentation :(

Unfortunately I'm with hughbris. From the documentation :

Rule Sets

Rule sets are similar in concept to subroutines and can be invoked by actions or another module. A rule set always works upon some specified arguments, with which its rules operate. So it's useful to create a rule set for some common tasks and to invoke it (by action) out of triggered rules when needed.

Example given: You want to log some user actions on a site. So you create a rule set, which takes the log message and its user and logs it, but only if the user has not disabled it. So you can invoke this rule set from multiple Triggered Rules, without the need of configuring the same condition again and again.

Can some kind person please translate this into something comprehensible to mere mortals like me ;-) I have a feeling that adding a rule set to a rule allows more actions to become available, relating to the arguments associated with the rulesset, but I'm very, very unclear.

Any pointers much appreciated.

El B

Take a look at node one's screencasts:
http://nodeone.se/blogg/learn-rules-with-nodeone-part-6-a-simple-rule-set is a good start.

See also: https://drupal.org/node/1300024