RE: A JIRA proposing a seperate repository for the online documentation

2018-03-19 Thread Kenneth Brotman
I've been trying to withdraw from the conversation since Friday. -Original Message- From: Josh McKenzie [mailto:jmcken...@apache.org] Sent: Monday, March 19, 2018 9:56 AM To: dev@cassandra.apache.org Subject: Re: A JIRA proposing a seperate repository for the online documentation A

Re: A JIRA proposing a seperate repository for the online documentation

2018-03-19 Thread Josh McKenzie
>> Rahul Singh has been making a very important point that different types of >> uses with different uses cases use the website. This is a public website; >> not an internal site for coders. >> >> Kenneth Brotman >> >> -Original Message- >> From: J

Re: A JIRA proposing a seperate repository for the online documentation

2018-03-19 Thread Josh McKenzie
ith different uses cases use the website. This is a public website; > not an internal site for coders. > > Kenneth Brotman > > -Original Message- > From: Josh McKenzie [mailto:jmcken...@apache.org] > Sent: Monday, March 19, 2018 7:42 AM > To: dev@cassandra.apache.org >

RE: A JIRA proposing a seperate repository for the online documentation

2018-03-19 Thread Kenneth Brotman
otman -Original Message- From: Josh McKenzie [mailto:jmcken...@apache.org] Sent: Monday, March 19, 2018 7:42 AM To: dev@cassandra.apache.org Subject: Re: A JIRA proposing a seperate repository for the online documentation Wow. Ok, let's try this again. Josh, you made my point for me.

Re: A JIRA proposing a seperate repository for the online documentation

2018-03-19 Thread Josh McKenzie
ken...@apache.org] > Sent: Monday, March 19, 2018 5:27 AM > To: dev@cassandra.apache.org > Subject: Re: A JIRA proposing a seperate repository for the online > documentation > > > > > I've been writing html a long time; since about 1990. You're asking >

RE: A JIRA proposing a seperate repository for the online documentation

2018-03-19 Thread Kenneth Brotman
: Josh McKenzie [mailto:jmcken...@apache.org] Sent: Monday, March 19, 2018 5:27 AM To: dev@cassandra.apache.org Subject: Re: A JIRA proposing a seperate repository for the online documentation > > I've been writing html a long time; since about 1990. You're asking > me to learn a w

Re: A JIRA proposing a seperate repository for the online documentation

2018-03-19 Thread Josh McKenzie
> > I've been writing html a long time; since about 1990. You're asking me to > learn a weird little program, a static site generator just to change > something I can already do without using a program at all. You're one person among a community of back-end Java devs. If you want people to contri

Re: A JIRA proposing a seperate repository for the online documentation

2018-03-18 Thread Nate McCall
On Mon, Mar 19, 2018 at 12:41 AM, Kenneth Brotman wrote: > I don't know what we are doing for the website technologies right now because > like everything else what we do is not documented anywhere. Where are the > servers: the cloud? What server software are we running? How is the html, > e

RE: A JIRA proposing a seperate repository for the online documentation

2018-03-18 Thread Kenneth Brotman
ve us well for now. Kenneth Brotman -Original Message- From: Kenneth Brotman [mailto:kenbrot...@yahoo.com.INVALID] Sent: Sunday, March 18, 2018 4:41 AM To: dev@cassandra.apache.org Subject: RE: A JIRA proposing a seperate repository for the online documentation I don't know what we ar

RE: A JIRA proposing a seperate repository for the online documentation

2018-03-18 Thread Kenneth Brotman
bsite? Kenneth Brotman -Original Message- From: Rahul Singh [mailto:rahul.xavier.si...@gmail.com] Sent: Saturday, March 17, 2018 7:12 AM To: dev@cassandra.apache.org Subject: RE: A JIRA proposing a seperate repository for the online documentation Static site generator just takes content

RE: A JIRA proposing a seperate repository for the online documentation

2018-03-17 Thread Rahul Singh
> Kenneth Brotman > > > -Original Message- > From: Rahul Singh [mailto:rahul.xavier.si...@gmail.com] > Sent: Saturday, March 17, 2018 5:57 AM > To: dev@cassandra.apache.org > Subject: RE: A JIRA proposing a seperate repository for the online > documentation &g

RE: A JIRA proposing a seperate repository for the online documentation

2018-03-17 Thread Kenneth Brotman
bsite that is dynamic and multi-media rich? Kenneth Brotman -Original Message- From: Rahul Singh [mailto:rahul.xavier.si...@gmail.com] Sent: Saturday, March 17, 2018 5:57 AM To: dev@cassandra.apache.org Subject: RE: A JIRA proposing a seperate repository for the online documentation I

RE: A JIRA proposing a seperate repository for the online documentation

2018-03-17 Thread Rahul Singh
> of others, and develop consensus around a direction. > > This is more difficult than demanding your way, or having someone(s) in a > position of absolute power tell you what you can and cannot do, but the > result is better. > > > > -Original Message- >

RE: A JIRA proposing a seperate repository for the online documentation

2018-03-16 Thread Kenneth Brotman
. -Original Message- From: beggles...@apple.com [mailto:beggles...@apple.com] Sent: Friday, March 16, 2018 3:16 PM To: dev@cassandra.apache.org Subject: Re: A JIRA proposing a seperate repository for the online documentation It would probably be more productive to list some specific concerns you have

Re: A JIRA proposing a seperate repository for the online documentation

2018-03-16 Thread Blake Eggleston
or me to do so. Let's see what we decide to do going forward for the website. Kenneth Brotman (Cassandra coder?) -Original Message- From: Eric Evans [mailto:john.eric.ev...@gmail.com] Sent: Friday, March 16, 2018 7:59 AM To: dev@cassandra.apache.org

RE: A JIRA proposing a seperate repository for the online documentation

2018-03-16 Thread Kenneth Brotman
ible for me to do so. Let's see what we decide to do going forward for the website. Kenneth Brotman (Cassandra coder?) -Original Message- From: Eric Evans [mailto:john.eric.ev...@gmail.com] Sent: Friday, March 16, 2018 7:59 AM To: dev@cassandra.apache.org Subject: Re: A JIRA prop

Re: A JIRA proposing a seperate repository for the online documentation

2018-03-16 Thread Eric Evans
t: Thursday, March 15, 2018 9:24 AM > To: dev@cassandra.apache.org > Subject: Re: A JIRA proposing a seperate repository for the online > documentation > > Murukesh is correct on a very useable, pretty standard process of > multi-versioned docs. > > I’ll put my thought

RE: A JIRA proposing a seperate repository for the online documentation

2018-03-15 Thread Kenneth Brotman
vote? Kenneth Brotman -Original Message- From: Jon Haddad [mailto:jonathan.had...@gmail.com] On Behalf Of Jon Haddad Sent: Thursday, March 15, 2018 9:24 AM To: dev@cassandra.apache.org Subject: Re: A JIRA proposing a seperate repository for the online documentation Murukesh is correct on a

Re: A JIRA proposing a seperate repository for the online documentation

2018-03-15 Thread Jon Haddad
hat seems to be the main blocker. I > think Jon has shown interest in moving to Hugo from the current Jekyll > setup. > > > >> Move our project onto a more suitable program than Sphinx for our needs? >> >> Kenneth Brotman >> >> -Original Message-

Re: A JIRA proposing a seperate repository for the online documentation

2018-03-15 Thread Murukesh Mohanan
> Move our project onto a more suitable program than Sphinx for our needs? > > Kenneth Brotman > > -Original Message- > From: Eric Evans [mailto:john.eric.ev...@gmail.com] > Sent: Thursday, March 15, 2018 7:50 AM > To: dev@cassandra.apache.org > Subject: Re: A JIRA propo

RE: A JIRA proposing a seperate repository for the online documentation

2018-03-15 Thread Kenneth Brotman
ric Evans [mailto:john.eric.ev...@gmail.com] Sent: Thursday, March 15, 2018 7:50 AM To: dev@cassandra.apache.org Subject: Re: A JIRA proposing a seperate repository for the online documentation On Thu, Mar 15, 2018 at 4:58 AM, Rahul Singh wrote: > > I don’t understand why it’s so complica

Re: A JIRA proposing a seperate repository for the online documentation

2018-03-15 Thread Eric Evans
On Thu, Mar 15, 2018 at 4:58 AM, Rahul Singh wrote: > > I don’t understand why it’s so complicated. In tree docs are as good as any. > All the old docs are there in the version control system. > > All we need to is a) generate docs for old versions b) improve user > experience on the site by hav

Re: A JIRA proposing a seperate repository for the online documentation

2018-03-15 Thread Rahul Singh
I don’t understand why it’s so complicated. In tree docs are as good as any. All the old docs are there in the version control system. All we need to is a) generate docs for old versions b) improve user experience on the site by having it clearly laid out what is latest vs. old docs. and c) hav

Re: A JIRA proposing a seperate repository for the online documentation

2018-03-14 Thread Murukesh Mohanan
I think this was how it was in the dark ages, with the wiki and all. I believe the reason why they shifted to in-tree docs is that this way, people who make changes to the code are more likely to make the corresponding doc changes as well, and reviewers have it easier to ensure docs are updated wit

A JIRA proposing a seperate repository for the online documentation

2018-03-14 Thread Kenneth Brotman
https://issues.apache.org/jira/browse/CASSANDRA-14313 For some reason I'm told by many committers that we should not have sets of documentation for other versions than the current version in a tree for that version. This has made it difficult, maybe impossible to have documentation for all the