Chart new versus existing example quality

Author: adewale

docs/example-quality-new-vs-old.csv

@@ -0,0 +1,70 @@
+cohort,slug,score
+Existing examples,hello-world,9.12
+Existing examples,values,9.44
+Existing examples,numbers,9.42
+Existing examples,booleans,9.32
+New syntax/graph examples,operators-and-literals,9.44
+Existing examples,none,9.70
+Existing examples,variables,9.44
+Existing examples,constants,9.32
+Existing examples,truthiness,9.70
+Existing examples,equality-and-identity,9.56
+Existing examples,mutability,9.44
+Existing examples,strings,9.68
+Existing examples,string-formatting,9.44
+Existing examples,conditionals,9.54
+New syntax/graph examples,assignment-expressions,9.34
+Existing examples,for-loops,9.46
+New syntax/graph examples,break-and-continue,9.24
+New syntax/graph examples,loop-else,9.34
+Existing examples,iterating-over-iterables,9.70
+Existing examples,iterators,9.56
+Existing examples,match-statements,8.84
+New syntax/graph examples,advanced-match-patterns,9.44
+Existing examples,while-loops,9.46
+Existing examples,lists,9.56
+Existing examples,tuples,9.56
+Existing examples,unpacking,9.66
+Existing examples,dicts,9.56
+Existing examples,sets,9.68
+Existing examples,slices,9.46
+Existing examples,comprehensions,9.68
+New syntax/graph examples,comprehension-patterns,9.46
+Existing examples,sorting,9.68
+Existing examples,functions,9.44
+Existing examples,keyword-only-arguments,9.32
+New syntax/graph examples,positional-only-parameters,9.34
+Existing examples,args-and-kwargs,9.56
+Existing examples,multiple-return-values,9.46
+Existing examples,closures,9.22
+New syntax/graph examples,scope-global-nonlocal,9.46
+Existing examples,recursion,8.65
+Existing examples,lambdas,9.56
+Existing examples,generators,9.46
+New syntax/graph examples,yield-from,9.46
+Existing examples,generator-expressions,9.44
+Existing examples,itertools,9.68
+Existing examples,decorators,9.34
+Existing examples,classes,8.44
+New syntax/graph examples,inheritance-and-super,9.34
+Existing examples,dataclasses,9.44
+Existing examples,properties,9.56
+Existing examples,special-methods,8.52
+New syntax/graph examples,metaclasses,8.89
+Existing examples,context-managers,9.58
+New syntax/graph examples,delete-statements,9.68
+Existing examples,exceptions,8.56
+New syntax/graph examples,assertions,9.46
+New syntax/graph examples,exception-chaining,9.34
+New syntax/graph examples,exception-groups,9.24
+Existing examples,modules,8.84
+New syntax/graph examples,import-aliases,8.56
+Existing examples,type-hints,8.77
+Existing examples,enums,9.46
+Existing examples,regular-expressions,9.66
+Existing examples,number-parsing,9.22
+Existing examples,custom-exceptions,9.32
+Existing examples,json,9.34
+Existing examples,datetime,9.54
+Existing examples,async-await,8.42
+New syntax/graph examples,async-iteration-and-context,8.84

docs/example-quality-new-vs-old.md

@@ -0,0 +1,23 @@
+# Example quality: new vs existing examples
+
+![Dot plot comparing quality scores for existing and newly added examples](example-quality-new-vs-old.svg)
+
+Scores come from `scripts/score_examples.py`, so this is a heuristic audit rather than a human rubric review. The “new” cohort is the syntax-surface/graph expansion added after commit `f6019d5`.
+
+| Cohort | Count | Average | Median | Min | Max |
+|---|---:|---:|---:|---:|---:|
+| Existing examples | 52 | 9.36 | 9.46 | 8.42 | 9.70 |
+| New syntax/graph examples | 17 | 9.29 | 9.34 | 8.56 | 9.68 |
+
+Lowest-scoring new examples under the heuristic:
+
+- `import-aliases` — 8.56
+- `async-iteration-and-context` — 8.84
+- `metaclasses` — 8.89
+- `break-and-continue` — 9.24
+- `exception-groups` — 9.24
+- `assignment-expressions` — 9.34
+- `loop-else` — 9.34
+- `positional-only-parameters` — 9.34
+
+The new examples are slightly lower on average because they cover compact, advanced, or edge-case syntax. That suggests the next editorial pass should deepen the lowest-scoring new pages with stronger problem framing and contrast, not remove them.