It's handy.
It's good to add documentation for some reason:
1. First of all it used in tools like WebStorm, which will help you complete directive params correctly if it has ngdoc or jsdoc
2. Not all features are described on you site like "attrs.translateCompile" in this directive. But many of them are really cool, like $http translations loading, but the only way to find out that they exists is to read all code, which is not cool actually

Of course I can remove this stuff if you wish.