Re: Official CS docs

2017-03-01 Thread benjamin roth
Thanks for the information! I think this approach works very well for purely technical docs like CQL documentation. For building a growing knowledge base I think the git repo is too developer-centric. A good example is that question about "fire drill" on the user list. There is someone who would l

Re: Official CS docs

2017-03-01 Thread Stefan Podkowinski
Hi Benjamin I think the best way to catch up with the motivation behind this is by reading the following dev post and linked jiras: https://lists.apache.org/thread.html/029e1273675260630e4973ba301f71a8de5a9d7e294a7b2df6eed65f@%3Cdev.cassandra.apache.org%3E What are your suggestions to improve th

Official CS docs

2017-03-01 Thread benjamin roth
Hi guys, Is there a reason that the docs are part of the git repo? In my personal opinion this is very complicated and it puts the hurdle to contribute to docs very high. There are so many questions on userlists that repeat over and over again and that could be put into a knowledge base. But ...