This is an awesome effort. Thank you Sent from my iPhone
> On Feb 27, 2018, at 1:17 PM, Carl Mueller <[email protected]> > wrote: > > Nice thanks > > >> On Tue, Feb 27, 2018 at 12:03 PM, Jon Haddad <[email protected]> wrote: >> There’s a section dedicated to contributing to Cassandra documentation in >> the docs as well: >> https://cassandra.apache.org/doc/latest/development/documentation.html >> >> >> >>> On Feb 27, 2018, at 9:55 AM, Kenneth Brotman <[email protected]> >>> wrote: >>> >>> I was just getting ready to install sphinx. Cool. >>> >>> From: Jon Haddad [mailto:[email protected]] On Behalf Of Jon Haddad >>> Sent: Tuesday, February 27, 2018 9:51 AM >>> To: [email protected] >>> Subject: Re: Filling in the blank To Do sections on the Apache Cassandra >>> web site >>> >>> The docs have been in tree for years :) >>> >>> https://github.com/apache/cassandra/tree/trunk/doc >>> >>> There’s even a docker image to build them so you don’t need to mess with >>> sphinx. Check the README for instructions. >>> >>> Jon >>> >>> >>> On Feb 27, 2018, at 9:49 AM, Carl Mueller <[email protected]> >>> wrote: >>> >>> If there was a github for the docs, we could start posting content to it >>> for review. Not sure what the review/contribution process is on Apache. >>> Google searches on apache documentation and similar run into lots of noise >>> from actual projects. >>> >>> I wouldn't mind trying to do a little doc work on the regular if there was >>> a wiki, a proven means to do collaborative docs. >>> >>> >>> On Tue, Feb 27, 2018 at 11:42 AM, Kenneth Brotman >>> <[email protected]> wrote: >>> It’s just content for web pages. There isn’t a working outline or any >>> draft on any of the JIRA’s yet. I like to keep things simple. Did I miss >>> something? What does it matter right now? >>> >>> Thanks Carl, >>> >>> Kenneth Brotman >>> >>> From: Carl Mueller [mailto:[email protected]] >>> Sent: Tuesday, February 27, 2018 8:50 AM >>> To: [email protected] >>> Subject: Re: Filling in the blank To Do sections on the Apache Cassandra >>> web site >>> >>> so... are those pages in the code tree of github? I don't see them or a >>> directory structure under /doc. Is mirroring the documentation between the >>> apache site and a github source a big issue? >>> >>> On Tue, Feb 27, 2018 at 7:50 AM, Kenneth Brotman >>> <[email protected]> wrote: >>> I was debating that. Splitting it up into smaller tasks makes each one >>> seem less over-whelming. >>> >>> Kenneth Brotman >>> >>> From: Josh McKenzie [mailto:jmckenzie@apacheorg] >>> Sent: Tuesday, February 27, 2018 5:44 AM >>> To: cassandra >>> Subject: Re: Filling in the blank To Do sections on the Apache Cassandra >>> web site >>> >>> Might help, organizationally, to put all these efforts under a single >>> ticket of "Improve web site Documentation" and add these as sub-tasks >>> Should be able to do that translation post-creation (i.e. in its current >>> state) if that's something that makes sense to you. >>> >>> On Mon, Feb 26, 2018 at 5:24 PM, Kenneth Brotman >>> <[email protected]> wrote: >>> Here are the related JIRA’s. Please add content even if It’s not well >>> formed compositionally. Myself or someone else will take it from there >>> >>> https://issues.apache.org/jira/browse/CASSANDRA-14274 The troubleshooting >>> section of the web site is empty >>> https://issues.apache.org/jira/browse/CASSANDRA-14273 The Bulk Loading web >>> page on the web site is empty >>> https://issues.apache.org/jira/browse/CASSANDRA-14272 The Backups web page >>> on the web site is empty >>> https://issues.apache.org/jira/browse/CASSANDRA-14271 The Hints web page >>> in the web site is empty >>> https://issues.apache.org/jira/browse/CASSANDRA-14270 The Read repair web >>> page is empty >>> https://issuesapache.org/jira/browse/CASSANDRA-14269 The Data Modeling >>> section of the web site is empty >>> https://issues.apache.org/jira/browse/CASSANDRA-14268 The >>> Architecture:Guarantees web page is empty >>> https://issuesapache.org/jira/browse/CASSANDRA-14267 The Dynamo web page >>> on the Apache Cassandra site is missing content >>> https://issues.apache.org/jira/browse/CASSANDRA-14266 The Architecture >>> Overview web page on the Apache Cassandra site is empty >>> >>> Thanks for pitching in >>> >>> Kenneth Brotman >>> >>> From: Kenneth Brotman [mailto:[email protected]] >>> Sent: Monday, February 26, 2018 1:54 PM >>> To: [email protected] >>> Subject: RE: Filling in the blank To Do sections on the Apache Cassandra >>> web site >>> >>> Nice! Thanks for the help Oliver! >>> >>> Kenneth Brotman >>> >>> From: Oliver Ruebenacker [mailto:[email protected]] >>> Sent: Sunday, February 25, 2018 7:12 AM >>> To: [email protected] >>> Cc: [email protected] >>> Subject: Re: Filling in the blank To Do sections on the Apache Cassandra >>> web site >>> >>> >>> Hello, >>> >>> I have some slides about Cassandra, feel free to borrow. >>> >>> Best, Oliver >>> >>> On Fri, Feb 23, 2018 at 7:28 PM, Kenneth Brotman >>> <[email protected]> wrote: >>> These nine web pages on the Apache Cassandra web site have blank To Do >>> sections. Most of the web pages are completely blank. Mind you there is a >>> lot of hard work already done on the documentation. I’ll make JIRA’s for >>> any of the blank sections where there is not already a JIRA. Then it will >>> be on to writing up those sections. If you have any text to help me get >>> started for any of these sections that would be really cool. >>> >>> >>> >>> http://cassandra.apache.org/doc/latest/architecture/overview.html >>> >>> >>> >>> http://cassandra.apacheorg/doc/latest/architecture/dynamo.html >>> >>> >>> >>> http://cassandra.apache.org/doc/latest/architecture/guarantees.html >>> >>> >>> >>> http://cassandra.apache.org/doc/latest/data_modeling/index.html >>> >>> >>> >>> http://cassandra.apacheorg/doc/latest/operating/read_repair.html >>> >>> >>> >>> http://cassandra.apache.org/doc/latest/operating/hints.html >>> >>> >>> >>> http://cassandra.apache.org/doc/latest/operating/backups.html >>> >>> >>> >>> http://cassandra.apache.org/doc/latest/operating/bulk_loading.html >>> >>> >>> >>> http://cassandra.apache.org/doc/latest/troubleshooting/index.html >>> >>> >>> >>> Kenneth Brotman >>> >>> >>> >>> >>> -- >>> Oliver Ruebenacker >>> Senior Software Engineer, Diabetes Portal, Broad Institute >> >
