{"action":"opened","issue":{"url":"https://api.github.com/repos/dart-lang/dartdoc/issues/1850","repository_url":"https://api.github.com/repos/dart-lang/dartdoc","labels_url":"https://api.github.com/repos/dart-lang/dartdoc/issues/1850/labels{/name}","comments_url":"https://api.github.com/repos/dart-lang/dartdoc/issues/1850/comments","events_url":"https://api.github.com/repos/dart-lang/dartdoc/issues/1850/events","html_url":"https://github.com/dart-lang/dartdoc/issues/1850","id":384530048,"node_id":"MDU6SXNzdWUzODQ1MzAwNDg=","number":1850,"title":"References to unnamed constructors don't work","user":{"login":"jamesderlin","id":17391434,"node_id":"MDQ6VXNlcjE3MzkxNDM0","avatar_url":"https://avatars3.githubusercontent.com/u/17391434?v=4","gravatar_id":"","url":"https://api.github.com/users/jamesderlin","html_url":"https://github.com/jamesderlin","followers_url":"https://api.github.com/users/jamesderlin/followers","following_url":"https://api.github.com/users/jamesderlin/following{/other_user}","gists_url":"https://api.github.com/users/jamesderlin/gists{/gist_id}","starred_url":"https://api.github.com/users/jamesderlin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jamesderlin/subscriptions","organizations_url":"https://api.github.com/users/jamesderlin/orgs","repos_url":"https://api.github.com/users/jamesderlin/repos","events_url":"https://api.github.com/users/jamesderlin/events{/privacy}","received_events_url":"https://api.github.com/users/jamesderlin/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":0,"created_at":"2018-11-26T22:03:57Z","updated_at":"2018-11-26T22:03:57Z","closed_at":null,"author_association":"NONE","body":"A specific case for #1663: [The Effective Dart guidelines](https://www.dartlang.org/guides/language/effective-dart/documentation#do-use-square-brackets-in-doc-comments-to-refer-to-in-scope-identifiers) claim:\r\n\r\n> The dot syntax can also be used to refer to named constructors. For the unnamed constructor, put parentheses after the class name:\r\n>\r\n> `/// To create a point, call [Point()] or use [Point.polar()] to ...`\r\n\r\nI just tested this with dartdoc 0.24.1 from the Dart 2.1 SDK, and the unnamed constructor reference doesn't seem to work; it links to the class instead.\r\n\r\nhttps://github.com/dart-lang/dartdoc/wiki/dartdoc-comment-references instead says to use `[MyClass.MyClass]` to reference the unnamed constructor.  That *does* work, but the generated documentation literally has `MyClass.MyClass`, which looks weird since that's not what anybody uses in code.  Can we do one (or both) of:\r\n\r\n* Make `[MyClass()]` refer to the unnamed constructor as claimed by Effective Dart? (Or, less desirably, fix the false claim by Effective Dart.)\r\n* Make `[MyClass.MyClass]` show up as `MyClass` (or `MyClass()`) in the generated documentation?\r\n\r\n?\r\n\r\nThe motivation for this was my attempt at removing lingering `new` usage in Flutter API documentation, which was used to disambiguate references to classes from references to constructors (https://github.com/flutter/flutter/pull/24625)."}}
{"actor":{"display_login":"jamesderlin"}}