add some documentation, particularly on BullCutter edge test and the offset ellipse.