I decided to remove JSDoc for directives for now, as agree with you when you say they should have their own file, and if that happens I believe the JSDoc would not be for the function itself, but for the file as a whole.