What documentation / guides do people want?

[davidmorgan]

Writing documentation is great, writing documentation that people actually want is even better ;)

So if you have any feedback on what would be useful to you, please drop it here and I'll prioritize based on that.

Thanks!

[dickermoshe]

I think each field of build.yaml really needs a much fuller explanation.

build_extension has 4 sentences devoted to it, yet it took this large article to make it even remotely understandable.
https://www.simonbinder.eu/posts/build_directory_moves/

$lib$ and $package$ are some magic values which are not documented anywhere.

Most of the build.yaml spec is located in the buiild_config package readme, but no-one actually installs this package, so it's not a very discoverable.

VScode support some sort of autocomplete in yaml files by providing a spec. If we have autocomplete and docs on hover in the build.yaml file it would be awesome.

[davidmorgan]

Thanks.

Actually ... build.yaml and build_extensions is probably one of the last bits of build_runner that I don't fully understand. By that I mean I don't have a good idea of what's possible, recommended best practices, and how it could be improved to better fit what people want.

Something I would definitely like to have is more like a cookbook / FAQ, with a list of things that are useful and how to achieve them, and a list of what people would like to do that isn't possible yet, and any plans to support them :)

[davidmorgan]

Started with the package:build API docs

#4205

I left a TODO for me on buildExtensions :)

[ykmnkmi]

I like to see how to filter files with native imports from build.

[ykmnkmi]

I mean in cases when you can compile application with dart2js, but not ddc. For example using ChangeType from watcher package.

[ykmnkmi]

It is defined in separated file, but exported with dart:io implementations.

[ykmnkmi]

My case is bringing build stack to web relying on analyzer FS implementation.

[davidmorgan]

This starts to sound like a large complex question unrelated to documentation ;)

I'm happy to dig into it if you'd like to open an issue

https://github.com/dart-lang/build

--if so could you please start at the beginning and explain what you're doing + why + what is currently working and then go on to what doesn't work, so I have a better chance to understand ;) thanks!

[ykmnkmi]

An application similar to the Vue/SolidJS/Svelte playgrounds, like Zapp.run. Work was paused when analyzer started removing macros and switching to the new API model. Compiled using dart2js.