made comment docs more explicit