Skip to content

Commit 694ab1a

Browse files
authored
async await codelab (#1659)
* Add WIP async await codelab * Limit lines to 80 chars * Round 1 of revisions: - add futures codelab to sidenav - add futures codelab to /codelabs page - update 'url' global to dart.dev - move futures codelab to /codelabs/async-await (formerly incorrectly placed in /language) - sundry content corrections in futures codelab * Add more updates per language comments/suggestions review feedback * Further small updates addressing review comments. * Configure site.alert templates and update futures codelab w/ templates * Add "Practicing" section iframe; slight restructure for "Errors" section * Added dartpad examples * Remove extra title * Remove section head and use of "future object" * Remove typos * Punctuate all bulleted list items. * Allow check-code to fail for dart dev builds * Correct mistaken exclusion of check-code from builds * Allow failure for check-code.sh * Allow failure for both check-code and analyze-and-test-examples * Updates per ux and tw review * More updates per review from @sfshaza2 * Updates per latest sfshaza2 comments * Incorporate first part of changes from UX round 2 * Correct typos, turn on latest DartPad UI, and misc small fxies * Update descriptions for examples * Add updates from observing test user * Minor update for example missing a border, extra sentence for DartPad * Re-organize introduction per latest feedback: - Remove heading for introduction - Remove DartPad example - Eliminate "key terms" section - Distribute key terms definitions across relevant portions codelab * Remove "!" characters from "Putting it all together" section * Adding changes from latest review * Refactored sync / async comparison section into 2 columns * Updated instructions before each example * Add changes before switching markup back to single-column view * Completed markup re-write * Finished updates from latest review comments * End with new lines for .travis.yml and .firebaserc * Remove dartpad includes file, update nav per review comments * Update codelab title * Incorporate suggestions from latest review * Enforce 80 char line limit * Small changes from latest review * Updates from latest review * Test omitting refresh-code-excerpts.sh - failing built * Remove test fix for build * Some changes based on recent review * Incorporate latest review items * Remove 'before running it' * Exercise applies to "Working with futures" * More updates - latest review * Add survey at the end of the codelab
1 parent f31716d commit 694ab1a

File tree

5 files changed

+531
-4
lines changed

5 files changed

+531
-4
lines changed

.gitignore

+1
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@
1010
.pub
1111
.*-cache/
1212
.vscode
13+
.spelling
1314
_asset_bundler_cache
1415
_bookhtml
1516
_cache/

_config.yml

+24
Original file line numberDiff line numberDiff line change
@@ -92,6 +92,30 @@ assets:
9292

9393
future: true # In support of https://github.com/dart-lang/site-www/issues/1111
9494

95+
## Site-wide shorthands
96+
97+
os-list: [Windows, macOS, Linux]
98+
99+
alert:
100+
important: >-
101+
<aside class="alert alert-warning" role="alert" markdown="1">
102+
<i class="fas fa-exclamation-circle"></i> **Important:**
103+
info: >-
104+
<aside class="alert alert-info" role="alert" markdown="1">
105+
<i class="fas fa-info-circle"></i>
106+
note: >-
107+
<aside class="alert alert-info" role="alert" markdown="1">
108+
<i class="fas fa-info-circle"></i> **Note:**
109+
secondary: >-
110+
<aside class="alert alert-secondary" role="alert" markdown="1">
111+
tip: >-
112+
<aside class="alert alert-success" role="alert" markdown="1">
113+
<i class="far fa-lightbulb"></i> **Tip:**
114+
warning: >-
115+
<aside class="alert alert-warning" role="alert" markdown="1">
116+
<i class="fas fa-exclamation-triangle"></i> **Warning:**
117+
end: </aside>
118+
95119
# bundler_args: --without production
96120
exclude: [diagrams]
97121
plugins: [jekyll-toc]

src/_data/side-nav.yml

+4-2
Original file line numberDiff line numberDiff line change
@@ -6,12 +6,14 @@
66
- title: Codelabs
77
expanded: true
88
children:
9-
- title: Overview
9+
- title: List of Dart codelabs
1010
urlExactMatch: true
1111
match-page-url-exactly: true
1212
permalink: /codelabs
13-
- title: Cheatsheet codelab
13+
- title: Language cheatsheet
1414
permalink: /codelabs/dart-cheatsheet
15+
- title: "Asynchrony: futures, async, await"
16+
permalink: /codelabs/async-await
1517
- title: Tutorials
1618
urlExactMatch: true
1719
match-page-url-exactly: true

0 commit comments

Comments
 (0)