Skip to content

Commit

Permalink
Revise Dart FAQ (dart-lang#5479)
Browse files Browse the repository at this point in the history
Revised for currency. @MaryaBelanger : Created a draft issue to revisit later. Thanks!

Fixes dart-lang#4673
  • Loading branch information
atsansone committed Feb 9, 2024
1 parent 97620e1 commit 88f4d45
Show file tree
Hide file tree
Showing 8 changed files with 203 additions and 324 deletions.
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

0 comments on commit 88f4d45

Please sign in to comment.