gson-comments/README.md

# google-gson
Gson is a Java library that can be used to convert Java Objects into their JSON representation. It can also be used to convert a JSON string to an equivalent Java object.
Gson can work with arbitrary Java objects including pre-existing objects that you do not have source-code of. 

There are a few open-source projects that can convert Java objects to JSON. However, most of them require that you place Java annotations in your classes; something that you can not do if you do not have access to the source-code. Most also do not fully support the use of Java Generics. Gson considers both of these as very important design goals. 

*Gson Goals*
  * Provide simple toJson() and fromJson() methods to convert Java objects to JSON and vice-versa
  * Allow pre-existing unmodifiable objects to be converted to and from JSON
  * Extensive support of Java Generics
  * Allow custom representations for objects
  * Support arbitrarily complex objects (with deep inheritance hierarchies and extensive use of generic types)

*Gson Downloads*
  * [Gson 2.4 Download](http://search.maven.org/#artifactdetails%7Ccom.google.code.gson%7Cgson%7C2.4%7Cjar) downloads at Maven Central

*Gson Documentation*
  * Gson [API](http://google.github.io/gson/apidocs/): Javadocs for the current Gson release
  * Gson [user guide](http://sites.google.com/site/gson/gson-user-guide): This guide contains examples on how to use Gson in your code.
  * Gson [Roadmap](https://sites.google.com/site/gson/gson-roadmap): Details on upcoming releases 
  * Gson [design document](https://sites.google.com/site/gson/gson-design-document): This document discusses issues we faced while designing Gson. It also include a comparison of Gson with other Java libraries that can be used for Json conversion

Please use the [google-gson Google group](http://groups.google.com/group/google-gson) to discuss Gson, or to post questions. 

*Gson-related Content Created by Third Parties*
  * [Gson Tutorial](http://www.studytrails.com/java/json/java-google-json-introduction.jsp) by `StudyTrails`
Create README.md 2015-03-19 21:33:05 +01:00			`# google-gson`
			`Gson is a Java library that can be used to convert Java Objects into their JSON representation. It can also be used to convert a JSON string to an equivalent Java object.`
			`Gson can work with arbitrary Java objects including pre-existing objects that you do not have source-code of.`

			`There are a few open-source projects that can convert Java objects to JSON. However, most of them require that you place Java annotations in your classes; something that you can not do if you do not have access to the source-code. Most also do not fully support the use of Java Generics. Gson considers both of these as very important design goals.`

			`Gson Goals`
			`* Provide simple toJson() and fromJson() methods to convert Java objects to JSON and vice-versa`
			`* Allow pre-existing unmodifiable objects to be converted to and from JSON`
			`* Extensive support of Java Generics`
			`* Allow custom representations for objects`
			`* Support arbitrarily complex objects (with deep inheritance hierarchies and extensive use of generic types)`

			`Gson Downloads`
updated to 2.4 release using apidocs from github pages 2015-10-04 02:58:57 +02:00			`* [Gson 2.4 Download](http://search.maven.org/#artifactdetails%7Ccom.google.code.gson%7Cgson%7C2.4%7Cjar) downloads at Maven Central`
Create README.md 2015-03-19 21:33:05 +01:00
			`Gson Documentation`
updated to 2.4 release using apidocs from github pages 2015-10-04 02:58:57 +02:00			`* Gson [API](http://google.github.io/gson/apidocs/): Javadocs for the current Gson release`
Correct 'user guide' and 'design document' Markdown links. 2015-04-13 18:22:11 +02:00			`* Gson [user guide](http://sites.google.com/site/gson/gson-user-guide): This guide contains examples on how to use Gson in your code.`
fixed links 2015-03-19 21:37:10 +01:00			`* Gson [Roadmap](https://sites.google.com/site/gson/gson-roadmap): Details on upcoming releases`
Correct 'user guide' and 'design document' Markdown links. 2015-04-13 18:22:11 +02:00			`* Gson [design document](https://sites.google.com/site/gson/gson-design-document): This document discusses issues we faced while designing Gson. It also include a comparison of Gson with other Java libraries that can be used for Json conversion`
Create README.md 2015-03-19 21:33:05 +01:00
fixed group link 2015-03-19 21:37:44 +01:00			`Please use the [google-gson Google group](http://groups.google.com/group/google-gson) to discuss Gson, or to post questions.`
Create README.md 2015-03-19 21:33:05 +01:00
			`Gson-related Content Created by Third Parties`
fixed links 2015-03-19 21:37:10 +01:00			* [Gson Tutorial](http://www.studytrails.com/java/json/java-google-json-introduction.jsp) by `StudyTrails`