Repository navigation
Update dartdoc to 1.0.0 - #85549
Update dartdoc to 1.0.0#85549
Conversation
gspencergoog
left a comment
There was a problem hiding this comment.
Where are the disambiguation instructions/syntax documented that you're using in #85484?
Sadly I plan to write the full specification now that the new lookup code is complete, which was kind of necessary as the old lookup code was many years of adhockery. I promise to send a copy. The design notes I wrote up at the start of the new lookup code project are at https://docs.google.com/document/d/11Vzx7PjSNo55YpVEx1BBUlEUPkl6CUpHZ4gFcefBE1I/edit?resourcekey=0-xUb52CNfZwq5FLt8LWSC7A#heading=h.xgjl2srtytjt but they do not include some aspects that I discovered along the way. |
|
This pull request is not suitable for automatic merging in its current state.
|

This includes some major internal changes that should improve performance (the AOT template compiler) and the new lookup code. The big changes noticeable for Flutter will be resolution of field formal parameters, extension method support, and more consistent disambiguation in comment reference lookups.
While a vast net improvement, this PR will change a few links to point to the wrong place. #85484 will address that after this lands, as there was no good way to specify what the user wanted unambiguously before dartdoc 1.0.0 in a few cases. That PR includes more details on the introduced regressions and link changes.
Release notes: https://github.com/dart-lang/dartdoc/releases/tag/v1.0.0