Skip to content

Commit f7cb68c

Browse files
Consolidate async docs away from old directories (#5771)
Contributes to #5766 and #5767 Co-authored-by: Marya <111139605+MaryaBelanger@users.noreply.github.com>
1 parent 8ad8d92 commit f7cb68c

File tree

10 files changed

+20
-32
lines changed

10 files changed

+20
-32
lines changed

firebase.json

+9-4
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@
3737
{ "source": "/articles/await-async", "destination": "/codelabs/async-await", "type": 301 },
3838
{ "source": "/articles/broadcast-streams", "destination": "https://medium.com/dartlang/dart-asynchronous-programming-streams-dab952023ed7", "type": 301 },
3939
{ "source": "/articles/converters-and-codecs", "destination": "/articles/archive/converters-and-codecs", "type": 301 },
40-
{ "source": "/articles/creating-streams", "destination": "/articles/libraries/creating-streams", "type": 301 },
40+
{ "source": "/articles/creating-streams", "destination": "/libraries/async/creating-streams", "type": 301 },
4141
{ "source": "/articles/dart-unit-tests{,/**}", "destination": "https://pub.dev/packages/test#writing-tests", "type": 301 },
4242
{ "source": "/articles/dart-vm/io", "destination": "/articles/libraries/dart-io", "type": 301 },
4343
{ "source": "/articles/dart-vm/native-extensions", "destination": "/server/c-interop-native-extensions", "type": 301 },
@@ -46,8 +46,8 @@
4646
{ "source": "/articles/design-decisions/why-dart-types", "destination": "/resources/faq#types", "type": 301 },
4747
{ "source": "/articles/doc-comment-guidelines", "destination": "/effective-dart/documentation", "type": 301 },
4848
{ "source": "/articles/event-loop", "destination": "https://medium.com/dartlang/dart-asynchronous-programming-isolates-and-event-loops-bffc3e296a6a", "type": 301 },
49-
{ "source": "/articles/feet-wet-streams{,/**}", "destination": "/tutorials/language/streams", "type": 301 },
50-
{ "source": "/articles/futures-and-error-handling", "destination": "/guides/libraries/futures-error-handling", "type": 301 },
49+
{ "source": "/articles/feet-wet-streams{,/**}", "destination": "/libraries/async/using-streams", "type": 301 },
50+
{ "source": "/articles/futures-and-error-handling", "destination": "/libraries/async/futures-error-handling", "type": 301 },
5151
{ "source": "/articles/idiomatic-dart{,/**}", "destination": "/effective-dart", "type": 301 },
5252
{ "source": "/articles/io", "destination": "/articles/libraries/dart-io", "type": 301 },
5353
{ "source": "/articles/js-dart-interop", "destination": "/web/libraries#js-interop", "type": 301 },
@@ -58,8 +58,10 @@
5858
{ "source": "/articles/language/optional-types", "destination": "/resources/faq#types", "type": 301 },
5959
{ "source": "/articles/libraries", "destination": "/libraries", "type": 301 },
6060
{ "source": "/articles/libraries/converters-and-codecs", "destination": "/articles/archive/converters-and-codecs", "type": 301 },
61+
{ "source": "/articles/libraries/creating-streams", "destination": "/libraries/async/creating-streams", "type": 301 },
6162
{ "source": "/articles/libraries/dart-io", "destination": "/libraries/dart-io", "type": 301 },
6263
{ "source": "/articles/libraries/zones", "destination": "/articles/archive/zones", "type": 301 },
64+
{ "source": "/articles/libraries*{,/**}", "destination": "/libraries", "type": 301 },
6365
{ "source": "/articles/m*{,/**}", "destination": "/guides/language/evolution", "type": 301 },
6466
{ "source": "/articles/mixins", "destination": "/language/mixins", "type": 301 },
6567
{ "source": "/articles/mocking-with-dart", "destination": "https://pub.dev/packages/mockito", "type": 301 },
@@ -132,7 +134,7 @@
132134
{ "source": "/docs/tutorials/indexeddb{,/**}", "destination": "https://api.dart.dev/stable/dart-indexed_db/dart-indexed_db-library.html", "type": 301 },
133135
{ "source": "/docs/tutorials/remove-elements", "destination": "/library/dart-html", "type": 301 },
134136
{ "source": "/docs/tutorials/shared-pkgs", "destination": "/guides/packages", "type": 301 },
135-
{ "source": "/docs/tutorials/streams", "destination": "/tutorials/language/streams", "type": 301 },
137+
{ "source": "/docs/tutorials/streams", "destination": "/libraries/async/using-streams", "type": 301 },
136138
{ "source": "/docs/tutorials{,/**}", "destination": "/tutorials", "type": 301 },
137139
{ "source": "/docs{,/**}", "destination": "/guides", "type": 301 },
138140
{ "source": "/downloads{,.html,/**}", "destination": "/get-dart", "type": 301 },
@@ -207,6 +209,7 @@
207209
{ "source": "/guides/language/type-system", "destination": "/language/type-system", "type": 301 },
208210
{ "source": "/guides/libraries", "destination": "/libraries", "type": 301 },
209211
{ "source": "/guides/libraries/create-library-packages", "destination": "/guides/libraries/create-packages", "type": 301 },
212+
{ "source": "/guides/libraries/futures-error-handling", "destination": "/libraries/async/futures-error-handling", "type": 301 },
210213
{ "source": "/guides/libraries/java-interop", "destination": "/interop/java-interop", "type": 301 },
211214
{ "source": "/guides/libraries/objective-c-interop", "destination": "/interop/objective-c-interop", "type": 301 },
212215
{ "source": "/guides/libraries/c-interop", "destination": "/interop/c-interop", "type": 301 },
@@ -295,7 +298,9 @@
295298
{ "source": "/tos@(|.htm|.html)", "destination": "/terms", "type": 301 },
296299
{ "source": "/tutorials/dart-vm", "destination": "/tutorials/server", "type": 301 },
297300
{ "source": "/tutorials/dart-vm/:page*", "destination": "/tutorials/server/:page*", "type": 301 },
301+
{ "source": "/tutorials/language", "destination": "/language", "type": 301 },
298302
{ "source": "/tutorials/language/futures", "destination": "/codelabs/async-await", "type": 301 },
303+
{ "source": "/tutorials/language/streams", "destination": "/libraries/async/using-streams", "type": 301 },
299304
{ "source": "/tutorials/libraries", "destination": "/libraries", "type": 301 },
300305
{ "source": "/tutorials/libraries/shared-pkgs", "destination": "/guides/packages", "type": 301 },
301306
{ "source": "/tutorials/web", "destination": "/web/get-started", "type": 301 },

src/_data/side-nav.yml

+3-3
Original file line numberDiff line numberDiff line change
@@ -139,11 +139,11 @@
139139
permalink: /libraries/dart-html
140140
- divider
141141
- title: Using streams
142-
permalink: /tutorials/language/streams
142+
permalink: /libraries/async/using-streams
143143
- title: Creating streams
144-
permalink: /articles/libraries/creating-streams
144+
permalink: /libraries/async/creating-streams
145145
- title: Futures and error handling
146-
permalink: /guides/libraries/futures-error-handling
146+
permalink: /libraries/async/futures-error-handling
147147

148148
- title: Effective Dart
149149
expanded: false

src/content/articles/archive/zones.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ This article discusses zone-related APIs in the [dart:async][] library,
2727
with a focus on the top-level [`runZoned()`][]
2828
and [`runZonedGuarded()`][] functions.
2929
Review the techniques covered in
30-
[Futures and Error Handling](/guides/libraries/futures-error-handling)
30+
[Futures and Error Handling](/libraries/async/futures-error-handling)
3131
before reading this article.
3232

3333
[dart:async]: ({{site.dart-api}}/{{site.sdkInfo.channel}}/dart-async/dart-async-library.html)

src/content/guides/language/coming-from/swift-to-dart.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -2689,7 +2689,7 @@ You can also create a stream using the
26892689
`StreamController` API. For more information,
26902690
see [Using a StreamController][].
26912691

2692-
[Using a StreamController]: /articles/libraries/creating-streams#using-a-streamcontroller
2692+
[Using a StreamController]: /libraries/async/creating-streams#using-a-streamcontroller
26932693

26942694
## Doc comments
26952695

src/content/articles/libraries/creating-streams.md src/content/libraries/async/creating-streams.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ This article shows the code for each approach
3636
and gives tips to help you implement your stream correctly.
3737

3838
For help on using streams, see
39-
[Asynchronous Programming: Streams](/tutorials/language/streams).
39+
[Asynchronous Programming: Streams](/libraries/async/using-streams).
4040

4141

4242
## Transforming an existing stream

src/content/tutorials/language/streams.md src/content/libraries/async/using-streams.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -391,9 +391,9 @@ error event, and when the stream is closed.
391391
Read the following documentation for more details on using streams
392392
and asynchronous programming in Dart.
393393

394-
* [Creating Streams in Dart](/articles/libraries/creating-streams),
394+
* [Creating Streams in Dart](/libraries/async/creating-streams),
395395
an article about creating your own streams
396-
* [Futures and Error Handling](/guides/libraries/futures-error-handling),
396+
* [Futures and Error Handling](/libraries/async/futures-error-handling),
397397
an article that explains how to handle errors using the Future API
398398
* [Asynchrony support](/language/async),
399399
a section in the [language tour](/language)

src/content/libraries/dart-async.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -456,9 +456,9 @@ check out the [dart:io documentation][].
456456
Also see these articles, codelabs, and tutorials:
457457

458458
- [Asynchronous programming: futures, async, await](/codelabs/async-await)
459-
- [Futures and error handling](/guides/libraries/futures-error-handling)
459+
- [Futures and error handling](/libraries/async/futures-error-handling)
460460
- [Asynchronous programming: streams](/tutorials/language/streams)
461-
- [Creating streams in Dart](/articles/libraries/creating-streams)
461+
- [Creating streams in Dart](/libraries/async/creating-streams)
462462
- [Dart asynchronous programming: Isolates and event loops](/language/concurrency)
463463

464464

src/content/tutorials/index.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ which are fundamental to most Dart programs.
2222

2323
<div class="card-grid no_toc_section">
2424
<div class="card">
25-
<h3><a href="/tutorials/language/streams">Asynchronous programming:
25+
<h3><a href="/libraries/async/using-streams">Asynchronous programming:
2626
streams</a></h3>
2727
<p>Use streams to manage sequences of data.</p>
2828
</div>

src/content/tutorials/language/index.md

-17
This file was deleted.

0 commit comments

Comments
 (0)