[
https://issues.apache.org/jira/browse/CASSANDRA-10248?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16909244#comment-16909244
]
Thibault Charbonnier commented on CASSANDRA-10248:
--------------------------------------------------
[~TanakaRM] In my view, the need to provide a compatibility matrix between
Cassandra and native protocol versions isn't for users of the client drivers,
but for _developers of the client drivers_ themselves. Client drivers must
document which version of Cassandra they are compatible with (for users), and
so should the binary protocol documentation (for maintainers). Given some
features are only available with specific versions of the binary protocol, it
is also useful to expose this information to users of the client drivers as
well. Hence, this information should be easily accessible in my opinion.
My personal experience (maintaining the Lua driver) was that figuring out which
version of Cassandra I needed to test my implementations of different versions
of the binary protocol was somewhat of a pain point. In the end, I had to write
a compatibility matrix myself, from information gathered in various other
drivers documentation or bits from the binary protocol specifications
(https://thibaultcha.github.io/lua-cassandra/manual/README.md.html).
My suggestion in this ticket is to include a similar table in the binary
specifications documentation
([https://github.com/apache/cassandra/blob/trunk/doc/native_protocol_v5.spec)]
so as to help current and future client drivers maintainers and users having a
clear vision of which version of the protocol is compatible with which version
of Cassandra, at a glance.
{quote}Do you think it makes sense to have the compatibility tables on
Cassandra's official documents?
{quote}
Yes, I very much do think so.
This is my feedback as a maintainer, thanks for taking the time to look at it!
> Document compatibilities between native specs and Cassandra versions
> --------------------------------------------------------------------
>
> Key: CASSANDRA-10248
> URL: https://issues.apache.org/jira/browse/CASSANDRA-10248
> Project: Cassandra
> Issue Type: Improvement
> Components: Legacy/Documentation and Website
> Reporter: Thibault Charbonnier
> Assignee: Tanaka
> Priority: Low
> Labels: documentation
>
> Nowhere in the native specs is specified for which Cassandra version it is
> compatible with. This has been confusing to me when implementing a given
> protocol in a Lua driver, and has apparently been confusing other people [1].
> I remember seeing a table specifying which specs were compatible with which
> Cassandra version somewhere in the Python driver documentation but I am
> currently unable to find it.
> Proposed solution: maybe include a small table in each specification file
> describing the compatibilities between Cassandra and the current (and
> eventually older) specs.
> [1]
> http://mail-archives.apache.org/mod_mbox/cassandra-dev/201504.mbox/%3ca87729c9-fa6a-4b34-bb7b-b324e154c...@datastax.com%3E
--
This message was sent by Atlassian JIRA
(v7.6.14#76016)
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
