Adds chapter 3, Async and HTTP, to the Dart first week experience #6629

lamek · 2025-05-29T23:24:16Z

updates to ch3

Thanks for your contribution! Please replace this text with a description of what this PR is changing or adding and why, list any relevant issues, and review the contribution guidelines below.

Fixes

I’ve reviewed the contributor guide and applied the relevant portions to this PR.
This PR doesn't contain automatically generated corrections or text (Grammarly, LLMs, and similar).
This PR follows the Google Developer Documentation Style Guidelines — for example, it doesn't use i.e. or e.g., and it avoids I and we (first person).
This PR uses semantic line breaks of 80 characters or fewer.

Contribution guidelines:

See our contributor guide for general expectations for PRs.
Larger or significant changes should be discussed in an issue before creating a PR.
Code changes should generally follow the Dart style guide and use dart format.
Updates to code excerpts indicated by <?code-excerpt need to be updated in their source .dart file as well.

dart-github-bot · 2025-05-29T23:26:35Z

Visit the preview URL for this PR (updated for commit ae2c82a):

https://dart-dev--pr6629-feature-guide-fwe-chapter-3-o2ec7h6a.web.app

updates to ch3 80 char

lamek · 2025-06-10T00:41:06Z

@ericwindmill At the end of this chapter, after doing the final test, the program doesn't terminate.

Do you think it's too complicated to close the HTTP client, or should we add that?

antfitch

Looking great! After you've finished with the technical review, let me know and I'll do a last minute editorial sweep over all of the things.

antfitch · 2025-06-10T21:44:18Z

src/content/get-started/add-commands.md

@@ -1,6 +1,14 @@
 ---
 title: Making your CLI program interactive


Make

(move to active voice in headings https://developers.google.com/style/headings)

antfitch · 2025-06-10T21:57:32Z

src/content/get-started/async.md

+
+In this chapter, you'll explore asynchronous programming in Dart, allowing your
+applications to perform multiple tasks concurrently. You'll learn how to fetch
+data from the internet using the `http` package, specifically retrieving an


Suggested change

data from the internet using the `http` package, specifically retrieving an

data from the internet using the `http` package to retrieve an

(I'd do a search for -ing present participles and gerunds and reduce the amount of them, if possible. )

antfitch · 2025-06-10T21:59:59Z

src/content/get-started/add-commands.md

-description: Add simple commands to your cli program. Learn the fundamentals of Dart syntax including control flow, collections, variables, functions, and more.
+short-title: Add commands
+description: >-
+  Add simple commands to your cli program. Learn the fundamentals of Dart syntax including control flow, collections, variables, functions, and more.


CLI application?

antfitch · 2025-06-10T23:52:15Z

src/content/get-started/async.md

+Before you can make HTTP requests, you need to add the `http` package
+as a dependency to your project.
+
+1.  Open the `dartpedia/pubspec.yaml` file within your project. This file is


It's a small thing, but can you change your numbers to use this format so that you don't have to worry about incrementation issues in the future:

1. stuff 1. more stuff 1. even more stuff

antfitch · 2025-06-10T23:54:24Z

src/content/get-started/async.md

+    ```
+
+    This line imports the `http` package and gives it the alias `http`.
+    This allows you to refer to classes and functions within the `http`


Suggested change

This allows you to refer to classes and functions within the `http`

After you do this, you can refer to classes and functions within the `http`

antfitch · 2025-06-11T00:15:23Z

src/content/get-started/async.md

+
+### Task 5: Update `main` to call `runApp`
+
+Finally, you need to update your `main` function to call the new `runApp` function when the `wikipedia` command is used.


Suggested change

Finally, you need to update your `main` function to call the new `runApp` function when the `wikipedia` command is used.

Finally, update your `main` function to call the new `runApp` function when the `wikipedia` command is used.

antfitch · 2025-06-11T00:16:27Z

src/content/get-started/async.md

+      }
+    }
+    ```
+    * `arguments.sublist(1)`: This extracts all elements from the `arguments` list starting from the second element (index 1). This effectively removes the `wikipedia` command itself, so `runApp` only receives the actual article title arguments.


Update formatting to match other sections.

antfitch · 2025-06-11T00:17:46Z

src/content/get-started/async.md

+    }
+    ```
+    * `arguments.sublist(1)`: This extracts all elements from the `arguments` list starting from the second element (index 1). This effectively removes the `wikipedia` command itself, so `runApp` only receives the actual article title arguments.
+    * `runApp(inputArgs)`: We call `runApp` directly. Since `main` doesn't need to do anything after `runApp` completes, we don't need to `await` it from `main` (and therefore `main` doesn't need to be `async`).


Avoid using 'we'. I'd do a search and replace.

antfitch · 2025-06-11T00:18:11Z

src/content/get-started/async.md

+
+### Task 6: Running the application
+
+Now that you've implemented the `http` request and integrated it into your application, let's test it out.


Suggested change

Now that you've implemented the `http` request and integrated it into your application, let's test it out.

Now that you've implemented the `http` request and integrated it into your application, test it out.

antfitch · 2025-06-11T00:19:03Z

src/content/get-started/async.md

+
+1.  Open your terminal and navigate to the `dartpedia` directory.
+2.  Run the command `dart run bin/cli.dart wikipedia Dart`.
+3.  The application should now fetch the summary of the "Dart" article from


Suggested change

3. The application should now fetch the summary of the "Dart" article from

3. Check to make sure that the application fetched the summary of the "Dart" article from

Try to start each step with the thing you want to do.

lamek added 2 commits June 9, 2025 16:02

added ch3

c34f9cd

updates to ch3 80 char

Adds ch3 and updates navigation to all chapters.

ae2c82a

lamek force-pushed the feature/guide/fwe-chapter-3 branch from 0f76fe3 to ae2c82a Compare June 10, 2025 00:33

antfitch requested review from antfitch, ericwindmill and parlough June 10, 2025 18:49

antfitch requested changes Jun 11, 2025

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Adds chapter 3, Async and HTTP, to the Dart first week experience #6629

Adds chapter 3, Async and HTTP, to the Dart first week experience #6629

lamek commented May 29, 2025

Uh oh!

dart-github-bot commented May 29, 2025 •

edited

Loading

Uh oh!

lamek commented Jun 10, 2025

Uh oh!

antfitch left a comment

Uh oh!

antfitch Jun 10, 2025

Uh oh!

antfitch Jun 10, 2025

Uh oh!

antfitch Jun 10, 2025

Uh oh!

antfitch Jun 10, 2025 •

edited

Loading

Uh oh!

antfitch Jun 10, 2025

Uh oh!

antfitch Jun 11, 2025

Uh oh!

antfitch Jun 11, 2025

Uh oh!

antfitch Jun 11, 2025

Uh oh!

antfitch Jun 11, 2025

Uh oh!

antfitch Jun 11, 2025

Uh oh!

antfitch Jun 11, 2025

Uh oh!

Uh oh!

		@@ -1,6 +1,14 @@
		---
		title: Making your CLI program interactive

	data from the internet using the `http` package, specifically retrieving an
	data from the internet using the `http` package to retrieve an

	This allows you to refer to classes and functions within the `http`
	After you do this, you can refer to classes and functions within the `http`


		### Task 5: Update `main` to call `runApp`

		Finally, you need to update your `main` function to call the new `runApp` function when the `wikipedia` command is used.

	Finally, you need to update your `main` function to call the new `runApp` function when the `wikipedia` command is used.
	Finally, update your `main` function to call the new `runApp` function when the `wikipedia` command is used.


		### Task 6: Running the application

		Now that you've implemented the `http` request and integrated it into your application, let's test it out.

	3. The application should now fetch the summary of the "Dart" article from
	3. Check to make sure that the application fetched the summary of the "Dart" article from

Adds chapter 3, Async and HTTP, to the Dart first week experience #6629

Are you sure you want to change the base?

Adds chapter 3, Async and HTTP, to the Dart first week experience #6629

Conversation

lamek commented May 29, 2025

Uh oh!

dart-github-bot commented May 29, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

lamek commented Jun 10, 2025

Uh oh!

antfitch left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

antfitch Jun 10, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

dart-github-bot commented May 29, 2025 •

edited

Loading

antfitch Jun 10, 2025 •

edited

Loading