[
https://issues.apache.org/jira/browse/CASSANDRA-11639?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Wei Deng updated CASSANDRA-11639:
---------------------------------
Description:
The guide_8099.md document that comes with the 8099 commit (dated Sep 1, 2014)
is a bit outdated.
For example, in many places of the Sep 1, 2014
[commit|https://github.com/apache/cassandra/tree/a991b64811f4d6adb6c7b31c0df52288eb06cf19]
we no longer use {{Atom}} to represent the unit when dealing with Row or
RangeTombstoneMarker and we use {{Unfiltered}} instead. However, you can still
find many references of {{Atom}} in this document. Also, AtomIterator is no
longer a thing and it's still referenced later in the document.
Another example of the outdated information is: we have removed all of the
"flyweight" pattern due to CASSANDRA-9705 in C* 3.0 GA, but this document still
talks about flyweight under a separate section.
One more example: CASSANDRA-8933 turns out is not a problem out of pure luck,
but we still have a section called "Short Reads" in this doc.
As this guide_8099.md is considered as a key document to an important area of
under-the-hood Cassandra implementation, to help new developers to navigate
this storage engine area better and to avoid unnecessary confusions, we should
strive to keep it as updated as possible.
was:
The guide_8099.md document that comes with the 8099 commit (dated Sep 1, 2014)
is a bit outdated.
For example, in many places of the Sep 1, 2014
[commit|https://github.com/apache/cassandra/tree/a991b64811f4d6adb6c7b31c0df52288eb06cf19]
we no longer use {{Atom}} to represent the unit when dealing with Row or
RangeTombstoneMarker and we use {{Unfiltered}} instead. However, you can still
find many references of {{Atom}} in this document. Also, AtomIterator is no
longer a thing and it's still referenced later in the document.
Another example of the outdated information is: we have removed all of the
"flyweight" pattern due to CASSANDRA-9705 in C* 3.0 GA, but this document still
talks about flyweight under a separate section.
As this guide_8099.md is considered as a key document to an important area of
under-the-hood Cassandra implementation, to help new developers to navigate
this storage engine area better and to avoid unnecessary confusions, we should
strive to keep it as updated as possible.
> guide_8099.md is a bit outdated
> -------------------------------
>
> Key: CASSANDRA-11639
> URL: https://issues.apache.org/jira/browse/CASSANDRA-11639
> Project: Cassandra
> Issue Type: Improvement
> Reporter: Wei Deng
>
> The guide_8099.md document that comes with the 8099 commit (dated Sep 1,
> 2014) is a bit outdated.
> For example, in many places of the Sep 1, 2014
> [commit|https://github.com/apache/cassandra/tree/a991b64811f4d6adb6c7b31c0df52288eb06cf19]
> we no longer use {{Atom}} to represent the unit when dealing with Row or
> RangeTombstoneMarker and we use {{Unfiltered}} instead. However, you can
> still find many references of {{Atom}} in this document. Also, AtomIterator
> is no longer a thing and it's still referenced later in the document.
> Another example of the outdated information is: we have removed all of the
> "flyweight" pattern due to CASSANDRA-9705 in C* 3.0 GA, but this document
> still talks about flyweight under a separate section.
> One more example: CASSANDRA-8933 turns out is not a problem out of pure luck,
> but we still have a section called "Short Reads" in this doc.
> As this guide_8099.md is considered as a key document to an important area of
> under-the-hood Cassandra implementation, to help new developers to navigate
> this storage engine area better and to avoid unnecessary confusions, we
> should strive to keep it as updated as possible.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
