Add mechanism to return rule documentations

[depryf]

We need to add a documentation method to each rule describing how it's calculated. Since many of our projects already support displaying some type of HTML help, I think it's OK to use some simple HTML tags in the description.