[ https://issues.apache.org/jira/browse/CASSANDRA-15481?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17042280#comment-17042280 ]
DeepakVohra edited comment on CASSANDRA-15481 at 2/22/20 12:20 AM: ------------------------------------------------------------------- [~rustyrazorblade] I would suggest keeping the index.rst page (https://github.com/Deepak-Vohra/cassandra/blob/data_modeling/doc/source/data_modeling/index.rst) I added as the first page of the documentation. And keep the *elaborate example* (http://cassandra.apache.org/doc/latest/data_modeling/index.html) from O'Reilly book as subsequent pages. I have discussed the important concepts though the example is not real-world and not too detailed. I would like to get opinion of other reviewers including from [~zznate] and [~djoshi] before you resolve the ticket. Could you reopen the ticket? The O'Reilly book chapter posted as documentation makes use of a *great example*, which I would suggest keeping, but has several issues: 1. It starts right-away with an example from the first statement, "First, let’s create a simple domain model that is easy to understand in the relational world, and then see how you might map it from a relational to a distributed hashtable model in Cassandra.", without discussing concepts. 1. Does not define what data modeling is. I have defined data modeling in "What is Data Modeling?". 2. Does not discuss some important concepts such as _Single table-single query_ approach, which I have discussed in "How does Apache Cassandra Model Data?" 3. Does not discuss how queries are selected, which I have discussed in "Selecting Queries to Support". 4. Does not compare with relational model, which I have in section "Comparing with Relational Data Model". 5. Does not discuss data model analysis such as _Data redundancies_, which I have discussed in "Data Model Analysis". 6. Does not discuss materialized views albeit as an experimental feature. was (Author: dvohra): [~rustyrazorblade] I would suggest keeping the index.rst page (https://github.com/Deepak-Vohra/cassandra/blob/data_modeling/doc/source/data_modeling/index.rst) I added as the first page of the documentation. And keep the *elaborate example* (http://cassandra.apache.org/doc/latest/data_modeling/index.html) from O'Reilly book as subsequent pages. I have discussed the important concepts though the example is not real-world and not too detailed. I would like to get opinion of other reviewers including from [~zznate]and [~djoshi] before you resolve the ticket. Could you reopen the ticket? The O'Reilly book chapter posted as documentation makes use of a *great example*, which I would suggest keeping, but has several issues: 1. It starts right-away with an example from the first statement, "First, let’s create a simple domain model that is easy to understand in the relational world, and then see how you might map it from a relational to a distributed hashtable model in Cassandra.", without discussing concepts. 1. Does not define what data modeling is. I have defined data modeling in "What is Data Modeling?". 2. Does not discuss some important concepts such as _Single table-single query_ approach, which I have discussed in "How does Apache Cassandra Model Data?" 3. Does not discuss how queries are selected, which I have discussed in "Selecting Queries to Support". 4. Does not compare with relational model, which I have in section "Comparing with Relational Data Model". 5. Does not discuss data model analysis such as _Data redundancies_, which I have discussed in "Data Model Analysis". 6. Does not discuss materialized views albeit as an experimental feature. > Data Modeling > ------------- > > Key: CASSANDRA-15481 > URL: https://issues.apache.org/jira/browse/CASSANDRA-15481 > Project: Cassandra > Issue Type: Sub-task > Components: Documentation/Website > Reporter: DeepakVohra > Assignee: DeepakVohra > Priority: Normal > Fix For: 4.0 > > > Added a page on data modeling. > https://github.com/apache/cassandra/pull/410 -- This message was sent by Atlassian Jira (v8.3.4#803005) --------------------------------------------------------------------- To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org For additional commands, e-mail: commits-h...@cassandra.apache.org