Each directive needs an example and the documentation should be organized in a better way than it is now. Probably externally hosted.