added rules to doc and README.md