DOC: explain behavior in comments