common: better comments