Skip to content

Remove User Guide links to non-existent Gson website#2861

Merged
eamonnmcmanus merged 1 commit intogoogle:mainfrom
Marcono1234:patch-1
May 30, 2025
Merged

Remove User Guide links to non-existent Gson website#2861
eamonnmcmanus merged 1 commit intogoogle:mainfrom
Marcono1234:patch-1

Conversation

@Marcono1234
Copy link
Copy Markdown
Contributor

Purpose

Fixes #2860

Description

https://sites.google.com/site/gson does not seem to exist anymore, and was most likely pretty outdated before anyway.

This pull request removes all references to it, which only existed in the User Guide.

Comment thread UserGuide.md
### Streaming

In addition Gson's object model and data binding, you can use Gson to read from and write to a [stream](https://sites.google.com/site/gson/streaming). You can also combine streaming and object model access to get the best of both approaches.
In addition Gson's object model and data binding, you can use Gson to read from and write to a stream with the classes [`JsonReader`](https://javadoc.io/doc/com.google.code.gson/gson/latest/com.google.gson/com/google/gson/stream/JsonReader.html) and [`JsonWriter`](https://javadoc.io/doc/com.google.code.gson/gson/latest/com.google.gson/com/google/gson/stream/JsonWriter.html). These classes operate on a JSON document as a sequence of tokens that are traversed in depth-first order. Because the streams operate on one token at a time, they impose minimal memory overhead.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Text is partially taken from https://web.archive.org/web/20221102163655/https://sites.google.com/site/gson/streaming. In combination with the links to JsonReader and JsonWriter this should hopefully suffice because their Javadoc also has usage examples.

Comment thread UserGuide.md

For many more, see the internal class [`TypeAdapters`](gson/src/main/java/com/google/gson/internal/bind/TypeAdapters.java).

You can also find source code for some commonly used classes such as JodaTime at [this page](https://sites.google.com/site/gson/gson-type-adapters-for-common-classes-1).
Copy link
Copy Markdown
Contributor Author

@Marcono1234 Marcono1234 May 29, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Simply removed this because Joda-Time is probably not that widely used anymore since the same classes exist since Java 8 under java.time. And the linked page apparently only included code for two classes, see https://web.archive.org/web/20221102153855/https://sites.google.com/site/gson/gson-type-adapters-for-common-classes-1.

Copy link
Copy Markdown
Member

@eamonnmcmanus eamonnmcmanus left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks!

@eamonnmcmanus eamonnmcmanus merged commit 330c613 into google:main May 30, 2025
11 checks passed
@Marcono1234 Marcono1234 deleted the patch-1 branch June 3, 2025 21:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

User guide link to streaming is broken

2 participants