Brian Wilkerson

I'm fairly sure that it's non-standard. We have added the extra information so that we could analyze the code samples to help ensure the correctness of the code snippets. Stripping...

I haven't yet thought of a counter example where it would fail, so I suspect that a regex would be sufficient for almost all cases.

It's kind of a cool idea, but ... Special casing always has a cost; if nothing else in all the other places where users then expect special handling and don't...

> ... and for reading deprecation messages as plain text. Whether they succeeded in their intentions is a question I'll ignore for the moment. But I'm somewhat familiar with what...

> Encouraging markdown only improves UX in the IDE ... I disagree. If you don't design for a targeted environment there's a good chance that the resulting UX will be...

By writing ``` Try doing one of the following: - the first alternative, - the second alternative, or - the third alternative. ``` and having the tool concatenate the lines....

I really shouldn't trust my memory. :-( Much of this conversation is moot. I should have double checked earlier, but it's been a rough day. I apologize. I tested both...

Given ``` /// hello http://google.com void f() {} ``` In IntelliJ, the URL does not become linkable in the hover text, but it is linked in the dartdoc comment. In...

Please see my comments on https://dart-review.googlesource.com/c/sdk/+/253824.

I suspect that we want this behavior to apply to any top-level declaration whose name matches (modulo identifier style) the name of the file in which it's declared.