add scaladoc for the new Directive API