Skip to content

Conversation

@Marcono1234
Copy link
Contributor

Improves Javadoc of multiple classes and adjusts the User Guide; some changes are based on the documentation changes in #2189.


/**
* A strategy (or policy) definition that is used to decide whether or not a field or top-level
* class should be serialized or deserialized as part of the JSON output/input. For serialization,
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Have moved some of this documentation to GsonBuilder because there (or rather in the internal Excluder) class this logic is implemented.

/**
* Returns whether the other object is equal to this. This method only considers
* the other object to be equal if it is an instance of {@code JsonPrimitive} and
* has an equal value.
Copy link
Contributor Author

Choose a reason for hiding this comment

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

I did not want to describe in detail how number comparison is performed because there are multiple open issues which show that there are potential flaws with the current logic.

@eamonnmcmanus
Copy link
Member

This all looks great. Thanks!

@eamonnmcmanus eamonnmcmanus merged commit 847d7f6 into google:master Sep 9, 2022
@Marcono1234 Marcono1234 deleted the marcono1234/documentation-improvements branch September 9, 2022 15:10
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.

2 participants