Reflect review comments on the documentation changes