Docs improvements

Some docs improvements solving some issues.
please add http://questions.vraptor.org/