This commit changes the documentation and the API documentation by
taking into account the newly introduced function
``talon.utils.directions``.

Minor style changes and typo fixes are also applied.