From a42bbf47d6b0d6f67ad843252cb2e8f56a9d32b7 Mon Sep 17 00:00:00 2001
From: Robert Griesemer <gri@golang.org>
Date: Tue, 1 Feb 2022 09:07:49 -0800
Subject: [PATCH] doc/go1.18: explain changes to compiler error messages

For #47694.
For #50954.

Change-Id: I3789e145d64025fe2bf787fa5d01a21832903586
Reviewed-on: https://go-review.googlesource.com/c/go/+/381968
Trust: Robert Griesemer <gri@golang.org>
Reviewed-by: Ian Lance Taylor <iant@golang.org>
---
 doc/go1.18.html | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/doc/go1.18.html b/doc/go1.18.html
index daf8755b28..b72c1288d1 100644
--- a/doc/go1.18.html
+++ b/doc/go1.18.html
@@ -443,6 +443,14 @@ Do not send CLs removing the interior tags from such phrases.
   new <code>go</code> command <code>-asan</code> option.
 </p>
 
+<p><!-- https://golang.org/issue/50954 -->
+  Because the compiler's type checker was replaced in its entirety to
+  support generics, some error messages now may use different wording
+  than before. In some cases, pre-Go 1.18 error messages provided more
+  detail or were phrased in a more helpful way.
+  We intend to address these cases in Go 1.19.
+</p>
+
 <p> <!-- https://github.com/golang/go/issues/49569 -->
   Because of changes in the compiler related to supporting generics, the
   Go 1.18 compile speed can be roughly 15% slower than the Go 1.17 compile speed.
-- 
2.48.1