some improvements on route registration, and some comments
Merge remote-tracking branch 'origin/master'