Dart API docs for analyzer Package are missing about sdk

[keertip]

@jonasfj , @athomas , any idea what might be happening here? Are the docs not getting generated?

[jonasfj]

See: https://pub.dev/packages/analyzer/score This is probably a macro issue... Since package:macro depends on _macro package from the SDK, it doesn't work with stable SDK. But since it's an indirect dependency we can detect SDK incompatibility. Fix could be for analyzer to make SDK constraint more explicit. Or for macros to be an actual SDK package, which we could then handle in Pana -- not that said infrastructure is in place yet.

…

On Wed, Jun 5, 2024, 20:59 Keerti Parthasarathy ***@***.***> wrote: @jonasfj <https://github.com/jonasfj> , @athomas <https://github.com/athomas> , any idea what might be happening here? Are the docs not getting generated? — Reply to this email directly, view it on GitHub <#55936 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AABERZDPFPTW7WAX3PSL6SLZF5N23AVCNFSM6AAAAABI2NZ55OVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDCNJQG42TIMZWGM> . You are receiving this because you were mentioned.Message ID: ***@***.***>

[bwilkerson]

@scheglov

[scheglov]

@jakemac53

[jakemac53]

I filed an issue related to this somewhere.... there isn't any reasonable solution that has been proposed afaik... this version of analyzer can only be analyzed on the absolute latest SDK.

We need to publish versions of these packages immediately after making certain changes to the _macros package, which is an SDK vendored dep. We could re-analyze and publish docs once a dev release is published potentially?

[jakemac53]

Ah, dart-lang/pub-dev#7597 is the core issue

[jonasfj]

Add a note to:
dart-lang/pub-dev#7597 (comment)

I think making package:macros an SDK would make the SDK constraints more explicit. And this would enable tools to be smarter.

This might be less painful when the latest version works with the latest stable SDK release, but whenever this is not the case packages using macros will feel more pain.

[jonasfj]

Hmm, I guess if we really want to pretend package:macros isn't an SDK package, we could hardcode into the SDK which versions its compatible with, and make all tooling understand that 🤣 -- but that was sort of what SDK packages was for in the first place (I think 🙈).