Update docs and remove deprecated code
Bump Linguist dep
Clarify documentation
Merge pull request #476 from citizen428/master

Clarify documentation