[doc] broken doc because of split, some import where missing
[doc] sphinx doesn't like this kind of indent
[doc] rst seems to prefer '-' to '*' for bullet lists