Not sure it matters, but I wouldn't put line comments between a dartdoc comment and what it's documenting, in case the parser doesn't properly pick up the dartdoc comment.