[MRG] docs improvements