mode documentation changes