My personal view if it is too hard or complicated to write documentation, too hard and complicated to explain how it works, then it is not worth doing.

I tried looking at it and got lost in lots magic $scope, $directives and other arcane constructs.

Yes I would have probably liked to have it described how you suggest, start with how it works.