DOC: api updates for .size