Well-known-struct-tags.md - wiki - Git at Google

 # Well-known struct tags
 ## Background

 Go offers [struct tags](https://golang.org/ref/spec#Tag) which are discoverable via reflection. These enjoy a wide range of use in the standard library in the JSON/XML and other encoding packages.

 The community welcomed them and has built ORMs, further encodings, flag parsers and much more around them since, especially for these tasks, single-sourcing is beneficial for data structures.

 ## Problem description
 Due to increased usage of Go and thus Go [struct tags](https://golang.org/ref/spec#Tag), clashes become inevitable.

 ## Solution
 The list below is a best effort to document well-known struct tags used by packages which are available to the public.

 ## Format of the list
 * Struct tag as extracted by calling https://godoc.org/reflect#StructTag.Get with this tag as the `key` argument.
 * Documentation link of this package using https://godoc.org

 ### Example entry
 Tag | Documentation
 ----|-----
 xml | https://godoc.org/encoding/xml

 ### Change Management
 List entries can be added by anyone who creates a public package where a new tag is used.
 List entries can be removed when the links to the package documentation stops working or the author(s) of that package requests it.

 ## List of well-known struct tags
 Tag       | Documentation
 ----------|---------------
 xml       | https://godoc.org/encoding/xml
 json      | https://godoc.org/encoding/json
 asn1      | https://godoc.org/encoding/asn1
 reform    | https://godoc.org/gopkg.in/reform.v1
 dynamodb  | https://docs.aws.amazon.com/sdk-for-go/api/service/dynamodb/dynamodbattribute/#Marshal
 bigquery  | https://godoc.org/cloud.google.com/go/bigquery
 datastore | https://godoc.org/cloud.google.com/go/datastore
 spanner   | https://godoc.org/cloud.google.com/go/spanner
 bson      | https://godoc.org/labix.org/v2/mgo/bson
 gorm      | https://godoc.org/github.com/jinzhu/gorm
 yaml      | https://godoc.org/gopkg.in/yaml.v2
 validate  | https://github.com/go-playground/validator
 mapstructure | https://godoc.org/github.com/mitchellh/mapstructure
 protobuf  | https://github.com/golang/protobuf
	# Well-known struct tags
	## Background

	Go offers [struct tags](https://golang.org/ref/spec#Tag) which are discoverable via reflection. These enjoy a wide range of use in the standard library in the JSON/XML and other encoding packages.

	The community welcomed them and has built ORMs, further encodings, flag parsers and much more around them since, especially for these tasks, single-sourcing is beneficial for data structures.

	## Problem description
	Due to increased usage of Go and thus Go [struct tags](https://golang.org/ref/spec#Tag), clashes become inevitable.

	## Solution
	The list below is a best effort to document well-known struct tags used by packages which are available to the public.

	## Format of the list
	* Struct tag as extracted by calling https://godoc.org/reflect#StructTag.Get with this tag as the `key` argument.
	* Documentation link of this package using https://godoc.org

	### Example entry
	Tag \| Documentation
	----\|-----
	xml \| https://godoc.org/encoding/xml

	### Change Management
	List entries can be added by anyone who creates a public package where a new tag is used.
	List entries can be removed when the links to the package documentation stops working or the author(s) of that package requests it.

	## List of well-known struct tags
	Tag \| Documentation
	----------\|---------------
	xml \| https://godoc.org/encoding/xml
	json \| https://godoc.org/encoding/json
	asn1 \| https://godoc.org/encoding/asn1
	reform \| https://godoc.org/gopkg.in/reform.v1
	dynamodb \| https://docs.aws.amazon.com/sdk-for-go/api/service/dynamodb/dynamodbattribute/#Marshal
	bigquery \| https://godoc.org/cloud.google.com/go/bigquery
	datastore \| https://godoc.org/cloud.google.com/go/datastore
	spanner \| https://godoc.org/cloud.google.com/go/spanner
	bson \| https://godoc.org/labix.org/v2/mgo/bson
	gorm \| https://godoc.org/github.com/jinzhu/gorm
	yaml \| https://godoc.org/gopkg.in/yaml.v2
	validate \| https://github.com/go-playground/validator
	mapstructure \| https://godoc.org/github.com/mitchellh/mapstructure
	protobuf \| https://github.com/golang/protobuf