doc fixes (iz remarks)