go/packages: remove scary warning on documentation
Add a guarantee for breaking changes.
Change-Id: I7c176eb0c3a309ad187e3a33a645996e397d09be
Reviewed-on: https://go-review.googlesource.com/c/141684
Reviewed-by: Alan Donovan <adonovan@google.com>
diff --git a/go/packages/doc.go b/go/packages/doc.go
index 61933de..f9dd1b0 100644
--- a/go/packages/doc.go
+++ b/go/packages/doc.go
@@ -5,11 +5,10 @@
/*
Package packages loads Go packages for inspection and analysis.
-NOTE: THIS PACKAGE IS NOT YET READY FOR WIDESPREAD USE:
- - The interface is still being revised and minor changes are likely.
- - The implementation depends on the Go 1.11 go command;
- support for earlier versions will be added soon.
- - We intend to finalize the API before Go 1.11 is released.
+Note: Though this package is ready for widespread use, we may make minor
+breaking changes if absolutely necessary. Any such change will be
+announced on golang-tools@ at least one week before it is committed. No
+more breaking changes will be made after December 1, 2018.
The Load function takes as input a list of patterns and return a list of Package
structs describing individual packages matched by those patterns.
