many more docs updates - explanations of split options