Directive documentation example

Here's a stub for how to document directives. I adopted `includecode` to extract one-line signatures of methods. The proposed structure of a directive documentation is
 
 - title
 - short description
 - signature
 - description
 - example

Examples are complete tests from `code/docs/directives/` where one test file corresponds to one directive trait.