[docs] Python documentation : some points requiring attention