adds comments to the actor_short partial. Documentation FTW.