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

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

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

n 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: Josh McKenzie [mailto:jmc

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

he 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 > Subject: Re: A JIRA proposin

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

-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. Lower

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

18 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 weird little program, a static site gener

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

[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 weird little program, a st

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 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

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

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

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

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 are doing

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

? 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 from

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

> > 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

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

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’ve previously deep dived

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

rch 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 > with Hugo. Then explain why you think they make using it a bad idea. Then &g

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

essage- > 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 &

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

. 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 proposing a seperate repository for the online documentation On Thu, Mar 15, 2018 at 11:40 AM

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

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 very useable, pretty standard process of > multi-versioned docs. >

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

? 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 very

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

inful, fiddly process. That 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 >> >>

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

r 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 pr

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

hn.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 <rahul.xavier.si...@gmail.com> wrote: > > I don’t understand why it’s s

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 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

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

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)

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

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

A JIRA proposing a seperate repository for the online documentation

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