updated vignette and improved polarity documentation