This MR:

* readds the docs for the emphasize parameter of the readfile shortcode
* adds emphasize in the example
* makes the number of parameters and their mandatory state clear
* makes it more obvious what the root directory should be
* does some minor language simplification

Closes #173