Documentation enhancements

This is related to #784
Why did you capitalize "pattern"?