version 0.5a, documentation and updates ruleset