The docs have been in tree for years :) https://github.com/apache/cassandra/tree/trunk/doc <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] <mailto:[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] > <mailto:[email protected]>] > Sent: Tuesday, February 27, 2018 8:50 AM > To: [email protected] <mailto:[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] <mailto:[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 > <mailto:[email protected]>] > 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] <mailto:[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 > <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 > <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 > <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 > <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 > <https://issues.apache.org/jira/browse/CASSANDRA-14270> The Read repair web > page is empty > > https://issuesapache.org/jira/browse/CASSANDRA-14269 > <https://issues.apache.org/jira/browse/CASSANDRA-14269> The Data Modeling > section of the web site is empty > > https://issues.apache.org/jira/browse/CASSANDRA-14268 > <https://issues.apache.org/jira/browse/CASSANDRA-14268> The > Architecture:Guarantees web page is empty > > https://issuesapache.org/jira/browse/CASSANDRA-14267 > <https://issues.apache.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 > <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] > <mailto:[email protected]>] > Sent: Monday, February 26, 2018 1:54 PM > To: [email protected] <mailto:[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] <mailto:[email protected]>] > Sent: Sunday, February 25, 2018 7:12 AM > To: [email protected] <mailto:[email protected]> > Cc: [email protected] <mailto:[email protected]> > Subject: Re: Filling in the blank To Do sections on the Apache Cassandra web > site > > > > > > Hello, > > I have some slides about Cassandra > <https://docs.google.com/presentation/d/1JZYugL4WC9grgZswg1i6gAfWmFBqg9iQ0YcPLUiQ-6w/edit?usp=sharing>, > feel free to borrow. > > Best, Oliver > > > > On Fri, Feb 23, 2018 at 7:28 PM, Kenneth Brotman > <[email protected] <mailto:[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.apache.org/doc/latest/architecture/overview.html> > > > http://cassandra.apacheorg/doc/latest/architecture/dynamo.html > <http://cassandra.apache.org/doc/latest/architecture/dynamo.html> > > > http://cassandra.apache.org/doc/latest/architecture/guarantees.html > <http://cassandra.apache.org/doc/latest/architecture/guaranteeshtml> > > > http://cassandra.apache.org/doc/latest/data_modeling/index.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/read_repair.html> > > > http://cassandra.apache.org/doc/latest/operating/hints.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/backups.html> > > > http://cassandra.apache.org/doc/latest/operating/bulk_loading.html > <http://cassandra.apache.org/doc/latest/operating/bulk_loading.html> > > > http://cassandra.apache.org/doc/latest/troubleshooting/index.html > <http://cassandra.apache.org/doc/latest/troubleshooting/index.html> > > > Kenneth Brotman > > > > > > > -- > > Oliver Ruebenacker > > Senior Software Engineer, Diabetes Portal > <http://www.type2diabetesgenetics.org/>, Broad Institute > <http://www.broadinstitute.org/> > > > > > > >
