use yardoc syntax for new documentation. It will look much better when we generate it.