[jira] Updated: (CASSANDRA-324) Add documentation to Thrift interface

["Gary Dusbabek (JIRA)" <ji...@apache.org>]

     [ https://issues.apache.org/jira/browse/CASSANDRA-324?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Gary Dusbabek updated CASSANDRA-324:
------------------------------------

    Attachment: 324-v1.patch

adds documentation and build task.

The process of getting to the website and then replacing the API page with it will be manual though.

> 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: Gary Dusbabek
>            Priority: Minor
>             Fix For: 0.5
>
>         Attachments: 324-v1.patch
>
>
> 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.