[
https://issues.apache.org/jira/browse/AVRO-1202?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13497384#comment-13497384
]
Doug Cutting commented on AVRO-1202:
------------------------------------
My instinct is to commit this as-is, then we can improve it with subsequent
patches. Does anyone object?
As for builder-or-not, the tradeoff is primarily that with the builder one gets
error messages sooner, while without it one gets better performance. Without
the builder the data is validated as the record is serialized, while with the
builder each value is checked as it is set but a copy of the datastructure must
be made before it is written which can impact performance. Also, a builder
will fill in default values automatically from the schema while the constructor
& setters will not.
> Add "Getting started" guide to documentation
> --------------------------------------------
>
> Key: AVRO-1202
> URL: https://issues.apache.org/jira/browse/AVRO-1202
> Project: Avro
> Issue Type: Improvement
> Components: doc
> Reporter: Skye Wanderman-Milne
> Assignee: Skye Wanderman-Milne
> Labels: documentation
> Fix For: 1.7.3
>
> Attachments: AVRO-1202.0.patch, AVRO-1202.0.tar.gz,
> AVRO-1202.1.patch, AVRO-1202.1.tar.gz, AVRO-1202.patch
>
>
> The Avro documentation is currently not very beginner-friendly -- it's hard
> to figure out basics like code generation, de/serialization, etc. We should
> write a "Getting started" guide and similar documentation for those new to
> Avro, as well as include some example code with the docs.
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira
