diff --git a/_config.yml b/_config.yml index 6c542e7404..57748320f9 100644 --- a/_config.yml +++ b/_config.yml @@ -38,6 +38,11 @@ pub-pkg: https://pub.dev/packages dartpad: https://dartpad.dev news: https://news.dartlang.org announce: https://groups.google.com/a/dartlang.org/g/announce +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 show_banner: true diff --git a/src/_includes/tools/utf-8.md b/src/_includes/tools/utf-8.md new file mode 100644 index 0000000000..d4499e479d --- /dev/null +++ b/src/_includes/tools/utf-8.md @@ -0,0 +1,3 @@ +The Dart language expects Dart code to be encoded using [UTF-8][utf8]. + +[utf8]: https://www.utf8.com/ \ No newline at end of file diff --git a/src/tools/sdk.md b/src/tools/sdk.md index da78dc311c..2865042204 100644 --- a/src/tools/sdk.md +++ b/src/tools/sdk.md @@ -4,12 +4,13 @@ description: Dart libraries and command-line tools. --- The Dart SDK has the libraries and command-line tools that you need to develop -Dart web, command-line, and server apps. To get the Dart SDK, see [Get Dart](/get-dart). -If you're developing Flutter apps, -then you don't need to separately download the Dart SDK; just [install Flutter.][flutter] +Dart web, command-line, and server apps. +To install the Dart SDK, see [Get Dart](/get-dart). +If you're developing Flutter apps, [install the Flutter SDK][flutter]. +The Flutter SDK includes the Dart SDK. -To learn about other tools you can use for Dart development, see -the [Dart tools](/tools) page. +To learn about other tools you can use for Dart development, +check out the [Dart tools](/tools) page. {{site.alert.version-note}} This site's documentation and examples use @@ -21,30 +22,34 @@ the [Dart tools](/tools) page. {% comment %} IMPORTANT: After each release, EDIT src/_data/pkg-vers.json to update the SDK version number. - More info: https://github.com/dart-lang/site-www/wiki/Updating-to-new-SDK-releases + More info: https://github.com/site-www/wiki/Updating-to-new-SDK-releases {% endcomment %} ## What's in the Dart SDK -The Dart SDK includes a `lib` directory for the [Dart libraries][] and a `bin` -directory that has these command-line tools: +The Dart SDK includes two directories: + +* `lib` contains the [Dart libraries][]. +* `bin` contains the following command-line tools. [`dart`](/tools/dart-tool) -: The command-line interface for creating, formatting, analyzing, testing, - documenting, compiling, and running Dart code. +: The command-line interface to create, format, analyze, test, + document, compile, and run Dart code. [`dartaotruntime`](/tools/dartaotruntime) : A Dart runtime for AOT-compiled snapshots. -For more information about the SDK, see its -[README file.](https://github.com/dart-lang/sdk/blob/main/README.dart-sdk) +{% include tools/utf-8.md %} + +To learn more about the SDK, check out its [README file][readme]. ## Filing bugs and feature requests To see existing issues or create a new one, -go to [the SDK issue tracker](https://github.com/dart-lang/sdk/issues). +go to [the SDK issue tracker][sdk-issues]. -[build the SDK from source]: https://github.com/dart-lang/sdk/wiki/Building [Dart libraries]: /libraries [flutter]: https://flutter.dev/docs/get-started/install [site SDK version]: {{site.dart-api}}/{{site.data.pkg-vers.SDK.channel}}/{{site.data.pkg-vers.SDK.vers}}/index.html +[readme]: ({{site.gh-dart.sdk}}/blob/main/README.dart-sdk) +[sdk-issues]: ({{site.gh-dart.sdk}}/issues)