Forward port docs from 2.2.x branch regarding new preferred way to use with intellij
Merge pull request #3192 from benmccann/intellijdocs

Forward port docs from 2.2.x branch regarding new preferred way to use intellij