dart-lang / site-www

The source for the Dart website.
https://dart.dev
Other
972 stars 704 forks source link

Document configuration-specific imports #4225

Open mit-mit opened 2 years ago

mit-mit commented 2 years ago

What information is missing?

We seem to be missing documentation on configuration specific imports. They are mentioned briefly here in the creating package docs: https://dart.dev/guides/libraries/create-library-packages#conditionally-importing-and-exporting-library-files

How would you like us to fix this problem?

Should be mentioned alongside the docs for imports, probably around here: https://dart.dev/guides/packages#importing-libraries-from-packages

Once we do that, we should link to it from the creating package docs.

mit-mit commented 2 years ago

cc @atsansone

@lrhn can probably help with eng. input

mit-mit commented 2 years ago

Here's the original proposal: https://github.com/lrhn/dep-configured-imports/blob/master/DEP-configured-imports.md

mit-mit commented 2 years ago

I'd like to adjust this to P2. There is a lot of mystery on how these work/