From: Damien Neil Date: Tue, 10 Jun 2025 20:55:09 +0000 (-0700) Subject: encoding/json/jsontext, encoding/json/v2: document experimental nature X-Git-Tag: go1.25rc2~2^2~62 X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=d166a0b03e;p=gostls13.git encoding/json/jsontext, encoding/json/v2: document experimental nature Change-Id: I7b2c391749e0113e006f37b2ac1ebfe3ee0a4e0e Reviewed-on: https://go-review.googlesource.com/c/go/+/680715 TryBot-Bypass: Damien Neil Reviewed-by: Cherry Mui Reviewed-by: Joseph Tsai Auto-Submit: Damien Neil --- diff --git a/src/encoding/json/jsontext/doc.go b/src/encoding/json/jsontext/doc.go index 755305151f..8a21ba70bd 100644 --- a/src/encoding/json/jsontext/doc.go +++ b/src/encoding/json/jsontext/doc.go @@ -10,6 +10,11 @@ // primitive data types such as booleans, strings, and numbers, // in addition to structured data types such as objects and arrays. // +// This package (encoding/json/jsontxt) is experimental, +// and not subject to the Go 1 compatibility promise. +// It only exists when building with the GOEXPERIMENT=jsonv2 environment variable set. +// Most users should use [encoding/json]. +// // The [Encoder] and [Decoder] types are used to encode or decode // a stream of JSON tokens or values. // diff --git a/src/encoding/json/v2/doc.go b/src/encoding/json/v2/doc.go index 8dd0b138f5..203139754c 100644 --- a/src/encoding/json/v2/doc.go +++ b/src/encoding/json/v2/doc.go @@ -9,6 +9,11 @@ // primitive data types such as booleans, strings, and numbers, // in addition to structured data types such as objects and arrays. // +// This package (encoding/json/v2) is experimental, +// and not subject to the Go 1 compatibility promise. +// It only exists when building with the GOEXPERIMENT=jsonv2 environment variable set. +// Most users should use [encoding/json]. +// // [Marshal] and [Unmarshal] encode and decode Go values // to/from JSON text contained within a []byte. // [MarshalWrite] and [UnmarshalRead] operate on JSON text