one new proposed plugin for raise statements + some more doc

I propose to check that all new raise statements are using the python 3 syntax.