Skip to content

Commit 4a8dd6c

Browse files
atsansoneparlough
andauthored
Add UTF-8 note (#5471)
Fixes #5453 --------- Co-authored-by: Parker Lougheed <parlough@gmail.com>
1 parent a7f1703 commit 4a8dd6c

File tree

3 files changed

+26
-13
lines changed

3 files changed

+26
-13
lines changed

_config.yml

+5
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,11 @@ pub-pkg: https://pub.dev/packages
3838
dartpad: https://dartpad.dev
3939
news: https://news.dartlang.org
4040
announce: https://groups.google.com/a/dartlang.org/g/announce
41+
gh: https://github.com
42+
gh-dart:
43+
org: https://github.com/dart-lang
44+
sdk: https://github.com/dart-lang/sdk
45+
site: https://github.com/dart-lang/website
4146

4247
show_banner: true
4348

src/_includes/tools/utf-8.md

+3
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
The Dart language expects Dart code to be encoded using [UTF-8][utf8].
2+
3+
[utf8]: https://www.utf8.com/

src/tools/sdk.md

+18-13
Original file line numberDiff line numberDiff line change
@@ -4,12 +4,13 @@ description: Dart libraries and command-line tools.
44
---
55

66
The Dart SDK has the libraries and command-line tools that you need to develop
7-
Dart web, command-line, and server apps. To get the Dart SDK, see [Get Dart](/get-dart).
8-
If you're developing Flutter apps,
9-
then you don't need to separately download the Dart SDK; just [install Flutter.][flutter]
7+
Dart web, command-line, and server apps.
8+
To install the Dart SDK, see [Get Dart](/get-dart).
9+
If you're developing Flutter apps, [install the Flutter SDK][flutter].
10+
The Flutter SDK includes the Dart SDK.
1011

11-
To learn about other tools you can use for Dart development, see
12-
the [Dart tools](/tools) page.
12+
To learn about other tools you can use for Dart development,
13+
check out the [Dart tools](/tools) page.
1314

1415
{{site.alert.version-note}}
1516
This site's documentation and examples use
@@ -26,25 +27,29 @@ the [Dart tools](/tools) page.
2627

2728
## What's in the Dart SDK
2829

29-
The Dart SDK includes a `lib` directory for the [Dart libraries][] and a `bin`
30-
directory that has these command-line tools:
30+
The Dart SDK includes two directories:
31+
32+
* `lib` contains the [Dart libraries][].
33+
* `bin` contains the following command-line tools.
3134

3235
[`dart`](/tools/dart-tool)
33-
: The command-line interface for creating, formatting, analyzing, testing,
34-
documenting, compiling, and running Dart code.
36+
: The command-line interface to create, format, analyze, test,
37+
document, compile, and run Dart code.
3538

3639
[`dartaotruntime`](/tools/dartaotruntime)
3740
: A Dart runtime for AOT-compiled snapshots.
3841

39-
For more information about the SDK, see its
40-
[README file.](https://github.com/dart-lang/sdk/blob/main/README.dart-sdk)
42+
{% include tools/utf-8.md %}
43+
44+
To learn more about the SDK, check out its [README file][readme].
4145

4246
## Filing bugs and feature requests
4347

4448
To see existing issues or create a new one,
45-
go to [the SDK issue tracker](https://github.com/dart-lang/sdk/issues).
49+
go to [the SDK issue tracker][sdk-issues].
4650

47-
[build the SDK from source]: https://github.com/dart-lang/sdk/wiki/Building
4851
[Dart libraries]: /libraries
4952
[flutter]: https://flutter.dev/docs/get-started/install
5053
[site SDK version]: {{site.dart-api}}/{{site.data.pkg-vers.SDK.channel}}/{{site.data.pkg-vers.SDK.vers}}/index.html
54+
[readme]: ({{site.gh-dart.sdk}}/blob/main/README.dart-sdk)
55+
[sdk-issues]: ({{site.gh-dart.sdk}}/issues)

0 commit comments

Comments
 (0)