dart-lang / dart-lang/webdev

Provide documentation around `--define` arguments

Open
#500 2 comments 0 reactions 0 assignees View on GitHub
package:webdev type-documentation
Dominant language
Dart
Stars
224
Forks
94
Avg merge
4d 3h
Merged PRs (30d)
2

Description

Our [docs for how to debug with dart2js](https://github.com/dart-lang/build/blob/master/docs/faq.md#how-can-i-debug-my-release-mode-web-app-dart2js) point to using `--define` but that doesn't work with `webdev`.

For now you can workaround with `pub run build_runner serve` instead of `webdev` but that option will go away eventually.

We either need to update the docs, or support the argument.

Contributor guide

Open the contributing guide

Research direction

Start with docs/faq.md and its dart2js debugging section, then inspect how webdev handles the --define argument compared with pub run build_runner serve. Done means either documenting a supported webdev workflow or establishing support for the argument, with the eventual removal of the workaround addressed.

Written by the indexing model from the issue text.

Assessment

Tech stack
dart
Domain
cli, documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.