my changes to sadi's doc