more explicit docs
mostly comments