Skip to content

Commit f1112b4

Browse files
Reframe HTTP lesson (#7032)
@parlough - You were so right about the async and http pages overlapping. The HTTP part of async is the most basic possible http request and really there for a "quick win", while the http lesson goes deeper. So I reframed the intro of http.md to be more clear about the difference. WDYT? --- - [x] I’ve reviewed the contributor guide and applied the relevant portions to this PR. - [x] This PR doesn't contain automatically generated corrections or text (Grammarly, LLMs, and similar). - [x] This PR follows the [Google Developer Documentation Style Guidelines](https://developers.google.com/style) — for example, it doesn't use _i.e._ or _e.g._, and it avoids _I_ and _we_ (first person). - [x] This PR uses [semantic line breaks](https://github.com/dart-lang/site-shared/blob/main/doc/writing-for-dart-and-flutter-websites.md#semantic-line-breaks) of 80 characters or fewer. --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
1 parent 6e9d3e9 commit f1112b4

File tree

1 file changed

+12
-12
lines changed

1 file changed

+12
-12
lines changed

src/content/get-started/http.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,8 @@
22
title: Http
33
shortTitle: Http
44
description: >-
5-
Implement Wikipedia API calls to complete the core functionality of the
6-
Wikipedia CLI.
5+
Refactor your application to use a robust, production-ready API client
6+
for the Wikipedia CLI.
77
sitemap: false
88
noindex: true
99
layout: learn
@@ -17,16 +17,16 @@ nextpage:
1717

1818
{% render 'fwe-wip-warning.md', site: site %}
1919

20-
In this chapter, you'll implement the core functionality of the Wikipedia CLI by
21-
making API calls to retrieve data. You'll add the `http` package as a
22-
dependency, create API functions, and then export those functions so they can be
23-
used by the `cli` package.
20+
In Chapter 3, you used the `http` package to make a simple request. Now, you'll
21+
revisit HTTP to build a robust, production-ready API client within the
22+
`wikipedia` package. You'll learn how to handle query parameters, map JSON
23+
responses to your data models, and export these functions for use in your CLI.
2424

2525
:::secondary What you'll learn
2626

27-
* Construct `Uri` objects for API requests.
28-
* Make HTTP GET requests using the `http` package.
29-
* Handle API responses and decode JSON data.
27+
* Construct complex `Uri` objects with query parameters.
28+
* Apply HTTP requests within a structured package architecture.
29+
* Map JSON responses to the data models created in Chapter 9.
3030
* Export functions and models from a Dart library.
3131

3232
:::
@@ -42,9 +42,9 @@ Before you begin this chapter, ensure you:
4242

4343
## Tasks
4444

45-
In this chapter, you'll add the core functionality of the Wikipedia CLI by
46-
making API calls to retrieve data. You'll work within the `wikipedia` package to
47-
implement the API client logic.
45+
In this chapter, you'll move beyond simple scripts and implement a proper API
46+
layer. You'll work within the `wikipedia` package to implement the API client
47+
logic, which improves your application's scalability and maintainability.
4848

4949
### Task 1: Add the http dependency to the wikipedia package
5050

0 commit comments

Comments
 (0)