[doc] More changes for clarity #5