updated documentation of where we are going