DOC: add revised docs (in advanced indexing) in regards to GH3219
see #3219
we now allow setting of mixed type frames with a ndarray/frame that can be aligned, docs mention the old behavior, need example maybe
