[ 
https://issues.apache.org/jira/browse/CASSANDRA-324?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12749602#action_12749602
 ] 

Jonathan Ellis commented on CASSANDRA-324:
------------------------------------------

(Ironically, I can't find any docs on "the doctext feature of Thrift" so that's 
the best I can do. :)

> Add documentation to Thrift interface
> -------------------------------------
>
>                 Key: CASSANDRA-324
>                 URL: https://issues.apache.org/jira/browse/CASSANDRA-324
>             Project: Cassandra
>          Issue Type: Improvement
>          Components: Documentation & website
>            Reporter: Michael Greene
>            Assignee: Michael Greene
>            Priority: Minor
>             Fix For: 0.5
>
>
> We should be using the doctext feature of Thrift to document all of our 
> enums, structs, and services.
> Rather than leaving individual wrapper libraries to document the interface, 
> it should be consolidated into one place (the .thrift file).  It can then be 
> used to generate javadocs for the stuff that gets placed in gen-java, 
> documentation for the Thrift-generated client libraries, or generate nifty 
> html using Thrift's own --gen html.

-- 
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