added user facing documentation