documentation update
fixed missing parentheses
corrected intro