start on documenting directives