a bit of documentation added to rules class