update: better comments/docs