more documentation on rules/clauses