Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Revise Dart FAQ #5479

Merged
merged 4 commits into from
Feb 5, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion _config.yml
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,8 @@ gh: https://github.com
gh-dart:
org: https://github.com/dart-lang
sdk: https://github.com/dart-lang/sdk
site: https://github.com/dart-lang/website
lang: https://github.com/dart-lang/language
site: https://github.com/dart-lang/site-www

show_banner: true

Expand Down
4 changes: 2 additions & 2 deletions src/_data/side-nav.yml
Original file line number Diff line number Diff line change
Expand Up @@ -336,8 +336,6 @@
- title: Resources
expanded: false
children:
- title: FAQ
permalink: /resources/faq
- title: Breaking changes
permalink: /resources/breaking-changes
- title: Language evolution
Expand All @@ -353,6 +351,8 @@
permalink: /guides/language/coming-from/js-to-dart
- title: Swift to Dart
permalink: /guides/language/coming-from/swift-to-dart
- title: FAQ
permalink: /resources/faq
- title: Glossary
permalink: /resources/glossary
- title: Books
Expand Down
4 changes: 4 additions & 0 deletions src/_sass/site.scss
Original file line number Diff line number Diff line change
Expand Up @@ -884,3 +884,7 @@ body.obsolete {
}
}
}

dd {
margin-left: 1rem;
}
4 changes: 0 additions & 4 deletions src/guides/whats-new.md
Original file line number Diff line number Diff line change
Expand Up @@ -285,9 +285,6 @@ we made the following changes to this site:
* New library directive section in [The language tour][]
* Improved clarity surrounding Dart's single-threaded or multi-threaded status:
* Removed the outdated `dart:io` page.
* Added two sections to the FAQ:
* [Is Dart single-threaded?][]
* [Is Dart single-threaded on the web?][]
* Expanded on [Dart's web concurrency capabilities][].
* Rearranged and clarified [discussion][] of default values for optional and positional parameters.
* Updated [Concurrency in Dart][] to default to new `Isolate.run()` function.
Expand All @@ -307,7 +304,6 @@ we made the following changes to this site:
[Automated publishing of packages to pub.dev]: /tools/pub/automated-publishing
[community resources section]: /community#additional-community-resources
[migration guide]: /null-safety/migration-guide
[Sound null safety]: /null-safety#dart-3-and-null-safety
[unsound null safety]: /null-safety/unsound-null-safety
[Learning Dart as a Swift developer]: /guides/language/coming-from/swift-to-dart
[booleans and equality operators]: /effective-dart/usage#dont-use-true-or-false-in-equality-operations
Expand Down
497 changes: 191 additions & 306 deletions src/resources/faq.md

Large diffs are not rendered by default.

5 changes: 0 additions & 5 deletions src/resources/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,11 +18,6 @@ Check out the following Dart language resources:
<p>Keeping community spaces safe and respectful.</p>
</div>

<div class="card">
<h3><a href="/resources/faq">Dart FAQ</a></h3>
<p>Answers to questions from the Dart community.</p>
</div>

<div class="card">
<h3><a href="/resources/videos">Videos</a></h3>
<p>Videos aimed at Dart developers.</p>
Expand Down
3 changes: 2 additions & 1 deletion src/tools/dartpad/troubleshoot.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,8 @@ The dart.dev homepage and many codelabs have embedded DartPads.
If these DartPads don't appear at all,
then try the following:

* Make sure you're using a [supported browser][browser].
* Make sure you're using one of the latest two versions of Chrome,
Edge, Firefox, or Safari.
DartPad might not work in other browsers, and is known not to work in
the default configuration of the Brave browser.

Expand Down
7 changes: 2 additions & 5 deletions src/tools/webdev.md
Original file line number Diff line number Diff line change
Expand Up @@ -112,7 +112,8 @@ assets on disk. This makes later builds compile faster.
The development compiler supports **only Chrome.**
To view your app in another browser,
use the production compiler.
For a list of supported browsers, [see the FAQ][supported browsers].
The production compiler supports the latest two versions of Chrome,
Edge, Firefox, and Safari.
{{site.alert.end}}

To enable [Dart DevTools][], add the `--debug` flag:
Expand Down Expand Up @@ -188,7 +189,6 @@ test package runner, use this command:
$ dart test -h
```


## More information

For a complete list of `webdev` options, run `webdev --help` or see the
Expand All @@ -205,11 +205,8 @@ Also see the following pages:
[compiler options](/tools/dart-compile#js).

[build_runner]: /tools/build_runner
[build_runner test]: #test
[build_web_compilers]: {{site.pub-pkg}}/build_web_compilers
[Dart DevTools]: /tools/dart-devtools
[dev_dependencies]: /tools/pub/dependencies#dev-dependencies
[PATH]: /tools/pub/cmd/pub-global#running-a-script-from-your-path
[supported browsers]: /resources/faq#q-what-browsers-do-you-support-as-javascript-compilation-targets
[test package]: {{site.pub-pkg}}/test
[webdev]: {{site.pub-pkg}}/webdev