[
https://issues.apache.org/jira/browse/CASSANDRA-20391?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17933797#comment-17933797
]
Stefan Miklosovic edited comment on CASSANDRA-20391 at 3/10/25 10:01 AM:
-------------------------------------------------------------------------
[~mck] [~bschoeni] should not we keep at least native-protocol.adoc?
There is doc/native_protocol_v5.spec manually changed when protocol changes. So
when corresponding adoc is committed, then on local building (ant artifacts), a
developer sees how it looks like rendered.
On the other hand, if we commit that, then people might start to think that
native-protocol.adoc is the source of truth and start to update that and leave
doc/native_protocol_v5.spec behind.
was (Author: smiklosovic):
[~mck] [~bschoeni] should not we keep at least native-protocol.adoc?
There is doc/native_protocol_v5.spec manually changed when protocol changes. So
when corresponding adoc is committed, then on local building (ant artifacts), a
developer sees how it looks like rendered.
On the other hand, if we commit that, then people might start to think that
native-protocol.adoc is the source of truth and start to update that on and
leave doc/native_protocol_v5.spec behind.
> Add generated native-protocol.adoc to .gitignore
> ------------------------------------------------
>
> Key: CASSANDRA-20391
> URL: https://issues.apache.org/jira/browse/CASSANDRA-20391
> Project: Apache Cassandra
> Issue Type: Improvement
> Reporter: Ling Mao
> Assignee: Ling Mao
> Priority: Low
> Fix For: 5.0.x
>
> Time Spent: 10m
> Remaining Estimate: 0h
>
> _*ant artifacts*_ to build the C* source code locally, but it generates the
> following file every time, which should be exempted form GIT.
> {code:java}
> doc/modules/cassandra/pages/reference/native-protocol.adoc {code}
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]