Some improvements to the documentation as suggested in #1503.
Some improvements to the documentation as suggested in #1503.

Closes #1503.

cblichmann/yara,cblichmann/yara,cblichmann/yara,cblichmann/yara,cblichmann/yara