elaborated documentation on rules