[
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 3:37 PM:
------------------------------------------------------------------
I have updated pull request to add an introduction page.
https://github.com/apache/cassandra/pull/410
[~rustyrazorblade] I would suggest keeping the page I added as the
introduction or 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.
2. Does not define what data modeling is. I have defined data modeling in "What
is Data Modeling?".
3. Does not discuss some important concepts such as
_Single table-single query_ approach, which I have discussed in
"How does Apache Cassandra Model Data?"
4. Does not discuss how queries are selected, which I have discussed in
"Selecting Queries to Support".
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.
2. Does not define what data modeling is. I have defined data modeling in "What
is Data Modeling?".
3. Does not discuss some important concepts such as
_Single table-single query_ approach, which I have discussed in
"How does Apache Cassandra Model Data?"
4. Does not discuss how queries are selected, which I have discussed in
"Selecting Queries to Support".
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: [email protected]
For additional commands, e-mail: [email protected]
