adds some documentation to rules and ruleset