[ 
https://issues.apache.org/jira/browse/AVRO-52?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12719510#action_12719510
 ] 

Sharad Agarwal commented on AVRO-52:
------------------------------------

Aren't the existing tests also doing the similar thing? In case more coverage 
is required, we can add more tests but for API usage illustration etc, won't 
tutorial documentation be more helpful than tests ? I think we should add to 
the docs to illustrate python APIs.

> Need a usage/lifecycle test to explain the python API
> -----------------------------------------------------
>
>                 Key: AVRO-52
>                 URL: https://issues.apache.org/jira/browse/AVRO-52
>             Project: Avro
>          Issue Type: Test
>          Components: python
>            Reporter: Philip Zeyliger
>         Attachments: AVRO-52.patch
>
>
> AVRO/python will eventually need something analogous to 
> http://wiki.apache.org/thrift/ThriftUsagePython, the Thrift Lightning talk at 
> http://x1024.net/blog/, or  
> http://code.google.com/apis/protocolbuffers/docs/pythontutorial.html .  While 
> the API is still being developed, however, it may make sense to simply have a 
> unit test that illustrates reasonable usage of the APIs.  This can also serve 
> as a place that users look at to learn the APIs and comment on their 
> friendliness and pythonicity.

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

Reply via email to