From: Alan Donovan <adonovan@google.com>
Date: Wed, 22 Oct 2025 21:56:32 +0000 (-0400)
Subject: doc/next: improve new(expr) release note
X-Git-Tag: go1.26rc1~527
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=77fc27972a;p=gostls13.git

doc/next: improve new(expr) release note

One reader pointed out that the example isn't compelling because
&age would have worked just as well. This CL changes the example
to use a nontrivial expression. Don't nitpick the arithmetic.

For #45624

Change-Id: Icc745f5ee7000c1d3559da1388c6a5596c4d1f46
Reviewed-on: https://go-review.googlesource.com/c/go/+/714040
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Auto-Submit: Alan Donovan <adonovan@google.com>
Reviewed-by: Robert Griesemer <gri@google.com>
---

diff --git a/doc/next/2-language.md b/doc/next/2-language.md
index ded7becf01..71da62f59e 100644
--- a/doc/next/2-language.md
+++ b/doc/next/2-language.md
@@ -19,10 +19,14 @@ type Person struct {
 	Age  *int     `json:"age"` // age if known; nil otherwise
 }
 
-func personJSON(name string, age int) ([]byte, error) {
+func personJSON(name string, born time.Time) ([]byte, error) {
 	return json.Marshal(Person{
 		Name: name,
-		Age:  new(age),
+		Age:  new(yearsSince(born)),
 	})
 }
+
+func yearsSince(t time.Time) int {
+	return int(time.Since(t).Hours() / (365.25 * 24)) // approximately
+}
 ```