Skip to content

Commit 88f4d45

Browse files
atsansoneTony Sansone
authored and
Tony Sansone
committed
Revise Dart FAQ (dart-lang#5479)
Revised for currency. @MaryaBelanger : Created a draft issue to revisit later. Thanks! Fixes dart-lang#4673
1 parent 97620e1 commit 88f4d45

File tree

8 files changed

+203
-324
lines changed

8 files changed

+203
-324
lines changed

_config.yml

+2-1
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,8 @@ gh: https://github.com
4242
gh-dart:
4343
org: https://github.com/dart-lang
4444
sdk: https://github.com/dart-lang/sdk
45-
site: https://github.com/dart-lang/website
45+
lang: https://github.com/dart-lang/language
46+
site: https://github.com/dart-lang/site-www
4647

4748
show_banner: true
4849

src/_data/side-nav.yml

+2-2
Original file line numberDiff line numberDiff line change
@@ -336,8 +336,6 @@
336336
- title: Resources
337337
expanded: false
338338
children:
339-
- title: FAQ
340-
permalink: /resources/faq
341339
- title: Breaking changes
342340
permalink: /resources/breaking-changes
343341
- title: Language evolution
@@ -353,6 +351,8 @@
353351
permalink: /guides/language/coming-from/js-to-dart
354352
- title: Swift to Dart
355353
permalink: /guides/language/coming-from/swift-to-dart
354+
- title: FAQ
355+
permalink: /resources/faq
356356
- title: Glossary
357357
permalink: /resources/glossary
358358
- title: Books

src/_sass/site.scss

+4
Original file line numberDiff line numberDiff line change
@@ -884,3 +884,7 @@ body.obsolete {
884884
}
885885
}
886886
}
887+
888+
dd {
889+
margin-left: 1rem;
890+
}

src/guides/whats-new.md

-4
Original file line numberDiff line numberDiff line change
@@ -285,9 +285,6 @@ we made the following changes to this site:
285285
* New library directive section in [The language tour][]
286286
* Improved clarity surrounding Dart's single-threaded or multi-threaded status:
287287
* Removed the outdated `dart:io` page.
288-
* Added two sections to the FAQ:
289-
* [Is Dart single-threaded?][]
290-
* [Is Dart single-threaded on the web?][]
291288
* Expanded on [Dart's web concurrency capabilities][].
292289
* Rearranged and clarified [discussion][] of default values for optional and positional parameters.
293290
* Updated [Concurrency in Dart][] to default to new `Isolate.run()` function.
@@ -307,7 +304,6 @@ we made the following changes to this site:
307304
[Automated publishing of packages to pub.dev]: /tools/pub/automated-publishing
308305
[community resources section]: /community#additional-community-resources
309306
[migration guide]: /null-safety/migration-guide
310-
[Sound null safety]: /null-safety#dart-3-and-null-safety
311307
[unsound null safety]: /null-safety/unsound-null-safety
312308
[Learning Dart as a Swift developer]: /guides/language/coming-from/swift-to-dart
313309
[booleans and equality operators]: /effective-dart/usage#dont-use-true-or-false-in-equality-operations

src/resources/faq.md

+191-306
Large diffs are not rendered by default.

src/resources/index.md

-5
Original file line numberDiff line numberDiff line change
@@ -18,11 +18,6 @@ Check out the following Dart language resources:
1818
<p>Keeping community spaces safe and respectful.</p>
1919
</div>
2020

21-
<div class="card">
22-
<h3><a href="/resources/faq">Dart FAQ</a></h3>
23-
<p>Answers to questions from the Dart community.</p>
24-
</div>
25-
2621
<div class="card">
2722
<h3><a href="/resources/videos">Videos</a></h3>
2823
<p>Videos aimed at Dart developers.</p>

src/tools/dartpad/troubleshoot.md

+2-1
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,8 @@ The dart.dev homepage and many codelabs have embedded DartPads.
1616
If these DartPads don't appear at all,
1717
then try the following:
1818

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

src/tools/webdev.md

+2-5
Original file line numberDiff line numberDiff line change
@@ -112,7 +112,8 @@ assets on disk. This makes later builds compile faster.
112112
The development compiler supports **only Chrome.**
113113
To view your app in another browser,
114114
use the production compiler.
115-
For a list of supported browsers, [see the FAQ][supported browsers].
115+
The production compiler supports the latest two versions of Chrome,
116+
Edge, Firefox, and Safari.
116117
{{site.alert.end}}
117118

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

191-
192192
## More information
193193

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

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

0 commit comments

Comments
 (0)