doc (directiveCompiler): document the process for later reading