avro-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Patrick Linehan (JIRA)" <j...@apache.org>
Subject [jira] Commented: (AVRO-153) Naming conventions for avro schemas, records and protocols
Date Sat, 23 Oct 2010 01:17:18 GMT

    [ https://issues.apache.org/jira/browse/AVRO-153?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12924105#action_12924105

Patrick Linehan commented on AVRO-153:

I think it makes sense to recommend naming conventions.  If not in the spec itself, at least
in some kind of "style guide" quickly accessible from the main Avro web pages.  Protobut has
a style guide in this vein:  http://code.google.com/apis/protocolbuffers/docs/style.html.

It would also be good to include on that page the recommended file extensions for the various
Avro files.  As a n00b, I had to induce this convention from disparate pages on the web. 
The convention seems to be:

*.avsc:  Avro type schema
*.avpr:  Avro protocol schema
*.avdl:  Avro IDL file
*.avro:  Avro data file

> Naming conventions for avro schemas, records and protocols
> ----------------------------------------------------------
>                 Key: AVRO-153
>                 URL: https://issues.apache.org/jira/browse/AVRO-153
>             Project: Avro
>          Issue Type: Improvement
>          Components: spec
>            Reporter: Philip Zeyliger
> It would be nice to add a few paragraphs to the spec with suggested naming conventions.
 I'm ambivalent as to what they actually are, but while the paint hasn't fully settled, it
might be nice to lead the project in one direction or another.
> Any thoughts on what the best style here is?

This message is automatically generated by JIRA.
You can reply to this email to add a comment to the issue online.

View raw message