Expand broad-surface pages, trim see_also, fix doc_path anchor

Removes the scope_first_pass shortcut from every broad-title page that
took it. Each page now demonstrates the canonical forms its title
promises rather than scoping itself down with a link list.

Broad-page expansions
- literals: hex/binary/octal/underscore numeric literals; f-string
  shown alongside raw and bytes literals.
- operators: bitwise & added with | and ^ to make the masking surface
  complete.
- type-hints: union (`X | Y`), `Optional[X]`, and `TypeAlias` cells.
- testing: setUp fixture, assertEqual, and assertRaises in a single
  TestCase. Runner output now reflects three test methods.
- async-await: async-with / async-for cell with an async context
  manager and async generator, linking to async-iteration-and-context.
- packages: builds a temporary `shapes` package on disk to make
  `from .submodule import name` and `__all__` concrete.
- regular-expressions: re.match vs re.search, re.compile, re.IGNORECASE
  flag, and re.sub each in their own cell.
- special-methods: equality/hashing/ordering, container protocols,
  callable, and context-manager dunders. The page is now a real tour.

Graph hygiene
- Trimmed see_also on literals, operators, inheritance-and-super,
  special-methods, and type-hints to ≤4 entries so audit_example_graph
  passes without warnings.

Doc-path correction
- bound-and-unbound-methods: doc_path was /reference/datamodel.html
  #methods (no such anchor); corrected to #instance-methods.

Verification
- All 109 examples verify under Python 3.13.
- 39 unit tests pass.
- Quality checks all green: registry-integrity, confusable-pairs,
  broad-surface-tours, footgun-coverage, notes-supported.
- score_examples reports every new page at 8.87 or higher (gate is 8.5).
- audit_example_graph --check exits 0.
- ruff, lint_seo_cache, format-examples --check, migration-parity all
  pass. Golden fixture refreshed to reflect the new cells.

Author: claude

src/asset_manifest.py

@@ -1,3 +1,3 @@
 # Generated by scripts/fingerprint_assets.py. Do not edit by hand.
 ASSET_PATHS = {'SITE_CSS': '/site.5f6f7da7c305.css', 'SYNTAX_JS': '/syntax-highlight.3b6c7f730d46.js', 'EDITOR_JS': '/editor.dd81f5171b14.js'}
-HTML_CACHE_VERSION = '6d04a8b5a41f'
+HTML_CACHE_VERSION = '781554af9745'

src/example_sources/async-await.md

@@ -4,7 +4,6 @@ title = "Async Await"
 section = "Async"
 summary = "async def creates coroutines, and await pauses until awaitable work completes."
 doc_path = "/library/asyncio-task.html"
-scope_first_pass = true
 see_also = [
   "async-iteration-and-context",
   "functions",
@@ -35,6 +34,30 @@ async def main():
     print(titles)
 
 asyncio.run(main())
+
+
+class Session:
+    async def __aenter__(self):
+        print("open")
+        return self
+
+    async def __aexit__(self, *_):
+        print("close")
+        return False
+
+
+async def stream():
+    for slug in ["json", "datetime"]:
+        await asyncio.sleep(0)
+        yield slug
+
+
+async def driver():
+    async with Session():
+        async for slug in stream():
+            print(slug)
+
+asyncio.run(driver())
 ```
 :::
 
@@ -90,6 +113,42 @@ asyncio.run(main())
 ```
 :::
 
+:::cell
+`async with` and `async for` are the asynchronous forms of context managers and iteration. A class implements `__aenter__`/`__aexit__` to act as an async context manager; an `async def` function with `yield` becomes an async generator. The dedicated [async iteration and context](/iteration/async-iteration-and-context) page explains the protocols in depth.
+
+```python
+class Session:
+    async def __aenter__(self):
+        print("open")
+        return self
+
+    async def __aexit__(self, *_):
+        print("close")
+        return False
+
+
+async def stream():
+    for slug in ["json", "datetime"]:
+        await asyncio.sleep(0)
+        yield slug
+
+
+async def driver():
+    async with Session():
+        async for slug in stream():
+            print(slug)
+
+asyncio.run(driver())
+```
+
+```output
+open
+json
+datetime
+close
+```
+:::
+
 :::note
 - Calling an async function creates a coroutine object.
 - `await` yields control until an awaitable completes.

src/example_sources/bound-and-unbound-methods.md

@@ -3,7 +3,7 @@ slug = "bound-and-unbound-methods"
 title = "Bound and Unbound Methods"
 section = "Data Model"
 summary = "instance.method binds self automatically; Class.method is a plain function."
-doc_path = "/reference/datamodel.html#methods"
+doc_path = "/reference/datamodel.html#instance-methods"
 see_also = [
   "classes",
   "attribute-access",

src/example_sources/inheritance-and-super.md

@@ -6,10 +6,9 @@ summary = "Inheritance reuses behavior, and super delegates to a parent implemen
 doc_path = "/tutorial/classes.html#inheritance"
 see_also = [
   "classes",
-  "properties",
-  "special-methods",
-  "classmethods-and-staticmethods",
   "abstract-base-classes",
+  "classmethods-and-staticmethods",
+  "special-methods",
 ]
 +++
 

src/example_sources/literals.md

@@ -4,14 +4,11 @@ title = "Literals"
 section = "Basics"
 summary = "Literals write values directly in Python source code."
 doc_path = "/reference/lexical_analysis.html#literals"
-scope_first_pass = true
 see_also = [
   "values",
   "strings",
-  "bytes-and-bytearray",
-  "dicts",
-  "string-formatting",
   "numbers",
+  "string-formatting",
 ]
 +++
 
@@ -28,12 +25,20 @@ fraction = 3.5
 complex_number = 2 + 3j
 print(whole, fraction, complex_number.imag)
 
+flags = 0xFF
+mask = 0b1010
+million = 1_000_000
+print(flags, mask, million)
+
 text = "python"
 raw_pattern = r"\d+"
 data = b"py"
+score = 98
+formatted = f"score={score}"
 print(text)
 print(raw_pattern)
 print(data)
+print(formatted)
 
 point = (2, 3)
 names = ["Ada", "Grace"]
@@ -69,21 +74,40 @@ print(whole, fraction, complex_number.imag)
 :::
 
 :::cell
-String literals write Unicode text. Raw strings keep backslashes literal, and bytes literals write binary data rather than text.
+Integer literals also accept hexadecimal (`0x`), binary (`0b`), and octal (`0o`) prefixes. Underscores group digits visually without changing the value.
+
+```python
+flags = 0xFF
+mask = 0b1010
+million = 1_000_000
+print(flags, mask, million)
+```
+
+```output
+255 10 1000000
+```
+:::
+
+:::cell
+String literals write Unicode text. Raw strings keep backslashes literal, bytes literals write binary data rather than text, and f-strings (`f"..."`) embed expressions inline.
 
 ```python
 text = "python"
 raw_pattern = r"\d+"
 data = b"py"
+score = 98
+formatted = f"score={score}"
 print(text)
 print(raw_pattern)
 print(data)
+print(formatted)
 ```
 
 ```output
 python
 \d+
 b'py'
+score=98
 ```
 :::
 

src/example_sources/operators.md

@@ -4,13 +4,11 @@ title = "Operators"
 section = "Basics"
 summary = "Operators combine, compare, and test values in expressions."
 doc_path = "/reference/expressions.html#operator-precedence"
-scope_first_pass = true
 see_also = [
   "numbers",
-  "conditionals",
+  "equality-and-identity",
   "assignment-expressions",
   "operator-overloading",
-  "equality-and-identity",
 ]
 +++
 
@@ -34,6 +32,8 @@ print(score == 100 or score >= 90)
 print("py" in "python")
 
 flags = 0b0011
+print(flags & 0b0101)
+print(flags | 0b0100)
 print(flags ^ 0b0101)
 print(flags << 1)
 
@@ -89,15 +89,19 @@ True
 :::
 
 :::cell
-Bitwise operators work on integer bit patterns. They are useful for masks and flags, not ordinary boolean logic.
+Bitwise operators work on integer bit patterns. They are useful for masks and flags, not ordinary boolean logic. `&` is bitwise AND, `|` is bitwise OR, `^` is exclusive OR, and `<<` shifts left.
 
 ```python
 flags = 0b0011
+print(flags & 0b0101)
+print(flags | 0b0100)
 print(flags ^ 0b0101)
 print(flags << 1)
 ```
 
 ```output
+1
+7
 6
 6
 ```

src/example_sources/packages.md

@@ -4,7 +4,6 @@ title = "Packages"
 section = "Modules"
 summary = "Packages organize modules into importable directories."
 doc_path = "/tutorial/modules.html#packages"
-scope_first_pass = true
 see_also = [
   "modules",
   "import-aliases",
@@ -30,6 +29,28 @@ print(json.__name__)
 print(json.decoder.__name__)
 print(module.JSONDecoder.__name__)
 print(module is json.decoder)
+
+
+import os
+import sys
+import tempfile
+
+with tempfile.TemporaryDirectory() as tmp:
+    pkg = os.path.join(tmp, "shapes")
+    os.makedirs(pkg)
+    with open(os.path.join(pkg, "__init__.py"), "w") as init:
+        init.write("from .square import area\n__all__ = ['area']\n")
+    with open(os.path.join(pkg, "square.py"), "w") as square:
+        square.write("def area(side):\n    return side * side\n")
+    sys.path.insert(0, tmp)
+    try:
+        import shapes
+        print(shapes.area(3))
+        print(shapes.__all__)
+    finally:
+        sys.path.remove(tmp)
+        sys.modules.pop("shapes", None)
+        sys.modules.pop("shapes.square", None)
 ```
 :::
 
@@ -78,8 +99,41 @@ True
 ```
 :::
 
+:::cell
+Inside a package's `__init__.py`, `from .submodule import name` re-exports a submodule's name at the package root, and `__all__` lists the names that `from package import *` should make visible. This cell builds a temporary `shapes` package on disk to make both forms concrete.
+
+```python
+import os
+import sys
+import tempfile
+
+with tempfile.TemporaryDirectory() as tmp:
+    pkg = os.path.join(tmp, "shapes")
+    os.makedirs(pkg)
+    with open(os.path.join(pkg, "__init__.py"), "w") as init:
+        init.write("from .square import area\n__all__ = ['area']\n")
+    with open(os.path.join(pkg, "square.py"), "w") as square:
+        square.write("def area(side):\n    return side * side\n")
+    sys.path.insert(0, tmp)
+    try:
+        import shapes
+        print(shapes.area(3))
+        print(shapes.__all__)
+    finally:
+        sys.path.remove(tmp)
+        sys.modules.pop("shapes", None)
+        sys.modules.pop("shapes.square", None)
+```
+
+```output
+9
+['area']
+```
+:::
+
 :::note
 - A package is a module that can contain submodules.
 - Dotted imports should mirror a meaningful project structure.
+- Use `from .submodule import name` inside a package to re-export submodule names; set `__all__` to declare the public surface.
 - Prefer ordinary imports unless the module name is truly dynamic.
 :::