Revamped comments for perception, action and deliberator.

Controller review is coming soon.