uhm we got partition wrong; fix later
add more doc on "advanced" operations