comment_references rule false-positive on markdown code blocks.

[dikmax]

Consider this example:

/// Some description
///
/// ```dart
/// /**
///  * Throws a [StateError] if ...
///  * similar to [anotherMethod], but ...
///  */
/// ```
///
/// More text.
void method() {}

In that case [StateError] and [anotherMethod] are not references.

[pq]

@scheglov : does analyzer do the right thing here? I'm guessing it's trying to resolve StateError and anotherMethod as if they were references.

[bwilkerson]

I suspect that's true. I don't think our parser is very intelligent about handling code blocks.

[scheglov]

Yes, we handle single line GitHub style code blocks, but we don't handle multi-line GitHub style comments.

[pq]

Yes, we handle single line GitHub style code blocks, but we don't handle multi-line GitHub style comments.

Should we? Does dartdoc? (cc @keertip)

[scheglov]

https://codereview.chromium.org/2302003003

[scheglov]

75d1ff0