more documentation, fixed some misplaced caps for user strings.