[website] WIP: _content/doc/jsonv2-migration: encoding/json/v2 migration guide

0 views
Skip to first unread message

Michael Pratt (Gerrit)

unread,
Aug 14, 2026, 1:21:35 PM (2 days ago) Aug 14
to Michael Pratt, goph...@pubsubhelper.golang.org, golang-...@googlegroups.com, golang...@luci-project-accounts.iam.gserviceaccount.com, Joseph Tsai, Damien Neil, Chris Hines, Jonathan Amsterdam, Austin Clements, Daniel Martí, Johan Brandhorst-Satzkorn, golang-co...@googlegroups.com

Michael Pratt submitted the change

Change information

Commit message:
_content/doc/jsonv2-migration: encoding/json/v2 migration guide

Migration documentation for encoding/json/v2. This is intended to be
more of a walkthrough guide compared to the reference documentation at
https://pkg.go.dev/encoding/js...@go1.27rc2#hdr-Migrating_to_v2.

This is still a pretty rough first draft. I feel that it may be a bit
too casual and the later sections are pretty aburt. I start with testing
option-by-option to get the concepts across, but I'm not sure many
people will actually want to migrate that way.

This focuses on marshaling (and unmarshaling). It should perhaps also
cover migrating json.Encoder/Decoder?

For golang/go#71497.
Change-Id: Ibaded378e760d009b770a9158157d44f6a6a6964
Reviewed-by: Damien Neil <dn...@google.com>
Reviewed-by: Jonathan Amsterdam <j...@google.com>
Reviewed-by: Chris Hines <chris....@gmail.com>
Reviewed-by: Joseph Tsai <joe...@digital-static.net>
Files:
  • M _content/doc/index.html
  • A _content/doc/jsonv2-migration.md
Change size: L
Delta: 2 files changed, 260 insertions(+), 0 deletions(-)
Branch: refs/heads/master
Submit Requirements:
Open in Gerrit
Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. DiffyGerrit
Gerrit-MessageType: merged
Gerrit-Project: website
Gerrit-Branch: master
Gerrit-Change-Id: Ibaded378e760d009b770a9158157d44f6a6a6964
Gerrit-Change-Number: 806921
Gerrit-PatchSet: 7
Gerrit-Owner: Michael Pratt <mpr...@google.com>
Gerrit-Reviewer: Chris Hines <chris....@gmail.com>
Gerrit-Reviewer: Damien Neil <dn...@google.com>
Gerrit-Reviewer: Jonathan Amsterdam <j...@google.com>
Gerrit-Reviewer: Joseph Tsai <joe...@digital-static.net>
Gerrit-Reviewer: Michael Pratt <mpr...@google.com>
Gerrit-CC: Austin Clements <aus...@google.com>
Gerrit-CC: Daniel Martí <mv...@mvdan.cc>
Gerrit-CC: Johan Brandhorst-Satzkorn <johan.br...@gmail.com>
open
diffy
satisfied_requirement
Reply all
Reply to author
Forward
0 new messages