From 08d10f9af1429d19633722e36f7bfeda6c000aa5 Mon Sep 17 00:00:00 2001
From: Alan Donovan <adonovan@google.com>
Date: Thu, 16 Aug 2018 16:31:45 -0400
Subject: [PATCH] doc: describe golang.org/x/go/packages in go1.11 release
 notes

Also, rename an HTML element ID to avoid duplicate.

Fixes golang/go#27038

Change-Id: Icc064a1cc86ddc794fc085d98b4cde3effff8ad0
Reviewed-on: https://go-review.googlesource.com/129635
Reviewed-by: Andrew Bonventre <andybons@golang.org>
Reviewed-by: Ian Cottrell <iancottrell@google.com>
---
 doc/go1.11.html | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/doc/go1.11.html b/doc/go1.11.html
index a1249db475..89649f34c0 100644
--- a/doc/go1.11.html
+++ b/doc/go1.11.html
@@ -167,7 +167,18 @@ Do not send CLs removing the interior tags from such phrases.
 <h3 id="gopackages">Package loading</h3>
 
 <p>
-  TODO: Note about go/build versus golang.org/x/tools/go/packages.
+  The new package
+  <a href="https://godoc.org/golang.org/x/tools/go/packages"><code>golang.org/x/tools/go/packages</code></a>
+  provides a simple API for locating and loading packages of Go source code.
+  Although not yet part of the standard library, for many tasks it
+  effectively replaces the <a href="/pkg/go/build"><code>go/build</code></a>
+  package, whose API is unable to fully support modules.
+  Because it runs an external query command such as
+  <a href="/cmd/go/#hdr-List_packages"><code>go list</code></a>
+  to obtain information about Go packages, it enables the construction of
+  analysis tools that work equally well with alternative build systems
+  such as <a href="https://bazel.build">Bazel</a>
+  and <a href="https://buckbuild.com">Buck</a>.
 </p>
 
 <h3 id="gocache">Build cache requirement</h3>
@@ -793,7 +804,7 @@ for k := range m {
 
 <!-- CL 101715 was reverted -->
 
-<dl id="runtime"><dt><a href="/pkg/runtime/">runtime</a></dt>
+<dl id="runtime-again"><dt><a href="/pkg/runtime/">runtime</a></dt>
   <dd>
 
     <p><!-- CL 70993 -->