MINOR Documentation slightly improved for js inclusion

Although I'm not the best documentor.
Minor language and readability fixes.
Merge pull request #2732 from Firesphere/patch-1

MINOR Documentation slightly improved for js inclusion