doc/next: reword map iterator function notes

The notes don't define identifiers m and seq. Describe in words
instead.

While here, rename 3-structs.md to 4-structs.md.

For #65614.

Change-Id: I6690f552903d1870c70e28673c87ac84b7c5c041
Reviewed-on: https://go-review.googlesource.com/c/go/+/592195
Reviewed-by: Ian Lance Taylor <iant@google.com>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>

diff --git a/doc/next/6-stdlib/3-iter.md b/doc/next/6-stdlib/3-iter.md
index 50179d949ed5f033b8acc2273e4d0c062ed9c75c..bbb3bbbd8f23e8b993d8e841703d0799ea464325 100644 (file)
--- a/doc/next/6-stdlib/3-iter.md
+++ b/doc/next/6-stdlib/3-iter.md
@@ -22,8 +22,8 @@ The [slices] package adds several functions that work with iterators:
   sub-slices of up to n elements of a slice.
 
 The [maps] package adds several functions that work with iterators:
-- [All](/pkg/maps#All) returns an iterator over key-value pairs from m.
-- [Keys](/pkg/maps#Keys) returns an iterator over keys in m.
-- [Values](/pkg/maps#Values) returns an iterator over values in m.
-- [Insert](/pkg/maps#Insert) adds the key-value pairs from seq to m.
-- [Collect](/pkg/maps#Collect) collects key-value pairs from seq into a new map and returns it.
+- [All](/pkg/maps#All) returns an iterator over key-value pairs from a map.
+- [Keys](/pkg/maps#Keys) returns an iterator over keys in a map.
+- [Values](/pkg/maps#Values) returns an iterator over values in a map.
+- [Insert](/pkg/maps#Insert) adds the key-value pairs from an iterator to an existing map.
+- [Collect](/pkg/maps#Collect) collects key-value pairs from an iterator into a new map and returns it.

diff --git a/doc/next/6-stdlib/3-structs.md b/doc/next/6-stdlib/4-structs.md
similarity index 100%
rename from doc/next/6-stdlib/3-structs.md
rename to doc/next/6-stdlib/4-structs.md