Docs for 3.0 go in the 3.0 branch. I’ve never heard of anyone shipping docs for multiple versions, I don’t know why we’d do that. You can get the docs for any version you need by downloading C*, the docs are included. I’m a firm -1 on changing that process.
Jon > On Mar 12, 2018, at 9:19 AM, Kenneth Brotman <kenbrot...@yahoo.com.INVALID> > wrote: > > It seems like the documentation that should be in the trunk for version 3.0, > should include information for users of version 3.0 and 2.1; the > documentation that should in 4.0 (when its released), should include > information for users of 4.0 and at least one previous version, etc. > > How about if we do it that way? > > Kenneth Brotman > > From: Jonathan Haddad [mailto:j...@jonhaddad.com] > Sent: Monday, March 12, 2018 9:10 AM > To: user@cassandra.apache.org > Subject: Re: What versions should the documentation support now? > > Right now they can’t. > On Mon, Mar 12, 2018 at 9:03 AM Kenneth Brotman <kenbrot...@yahoo.com.invalid > <mailto:kenbrot...@yahoo.com.invalid>> wrote: >> I see how that makes sense Jon but how does a user then select the >> documentation for the version they are running on the Apache Cassandra web >> site? >> >> Kenneth Brotman >> >> From: Jonathan Haddad [mailto:j...@jonhaddad.com >> <mailto:j...@jonhaddad.com>] >> Sent: Monday, March 12, 2018 8:40 AM >> >> To: user@cassandra.apache.org <mailto:user@cassandra.apache.org> >> Subject: Re: What versions should the documentation support now? >> >> The docs are in tree, meaning they are versioned, and should be written for >> the version they correspond to. Trunk docs should reflect the current state >> of trunk, and shouldn’t have caveats for other versions. >> On Mon, Mar 12, 2018 at 8:15 AM Kenneth Brotman <kenbrotman@yahoocom.invalid >> <mailto:kenbrot...@yahoo.com.invalid>> wrote: >>> If we use DataStax’s example, we would have instructions for v3.0 and v2.1. >>> How’s that? >>> >>> We should have to be instructions for the cloud platforms like AWS but how >>> do you do that and stay vendor neutral? >>> >>> Kenneth Brotman >>> >>> From: Hannu Kröger [mailto:hkro...@gmail.com <mailto:hkro...@gmail.com>] >>> Sent: Monday, March 12, 2018 7:40 AM >>> To: user@cassandra.apache.org <mailto:user@cassandra.apache.org> >>> Subject: Re: What versions should the documentation support now? >>> >>> In my opinion, a good documentation should somehow include version specific >>> pieces of information. Whether it is nodetool command that came in certain >>> version or parameter for something or something else. >>> >>> That would very useful. It’s confusing if I see documentation talking about >>> 4.0 specifics and I try to find that in my 3.11.x >>> >>> Hannu >>> >>> >>> On 12 Mar 2018, at 16:38, Kenneth Brotman <kenbrot...@yahoo.com.INVALID >>> <mailto:kenbrot...@yahoo.com.INVALID>> wrote: >>> >>> I’m unclear what versions are most popular right now? What version are you >>> running? >>> >>> What version should still be supported in the documentation? For example, >>> I’m turning my attention back to writing a section on adding a data center. >>> What versions should I support in that information? >>> >>> I’m working on it right now. Thanks, >>> >>> Kenneth Brotman
