Add basic documentation for with_capacity
Move documentation for vec::windowed where it will be generated
auto merge of #6055 : cmr/rust/incoming, r=graydon,brson