added documentation from hero.js comments