I'd love to see more design discussions consolidated in a single place as well. That said, there are many practical challenges to overcome. Some of them are out of our control:
1. For large features, it is fairly common to open a PR for discussion, close the PR taking some feedback into account, and reopen another one. You sort of lose the discussions that way. 2. With the way Jenkins is setup currently, Jenkins testing introduces a lot of noise to GitHub pull requests, making it hard to differentiate legitimate comments from noise. This is unfortunately due to the fact that ASF won't allow our Jenkins bot to have API privilege to post messages. 3. The Apache Way is that all development discussions need to happen on ASF property, i.e. dev lists and JIRA. As a result, technically we are not allowed to have development discussions on GitHub. On Fri, Apr 24, 2015 at 7:09 AM, Cody Koeninger <c...@koeninger.org> wrote: > My 2 cents - I'd rather see design docs in github pull requests (using > plain text / markdown). That doesn't require changing access or adding > people, and github PRs already allow for conversation / email > notifications. > > Conversation is already split between jira and github PRs. Having a third > stream of conversation in Google Docs just leads to things being ignored. > > On Fri, Apr 24, 2015 at 7:21 AM, Sean Owen <so...@cloudera.com> wrote: > > > That would require giving wiki access to everyone or manually adding > people > > any time they make a doc. > > > > I don't see how this helps though. They're still docs on the internet and > > they're still linked from the central project JIRA, which is what you > > should follow. > > On Apr 24, 2015 8:14 AM, "Punyashloka Biswal" <punya.bis...@gmail.com> > > wrote: > > > > > Dear Spark devs, > > > > > > Right now, design docs are stored on Google docs and linked from > tickets. > > > For someone new to the project, it's hard to figure out what subjects > are > > > being discussed, what organization to follow for new feature proposals, > > > etc. > > > > > > Would it make sense to consolidate future design docs in either a > > > designated area on the Apache Confluence Wiki, or on GitHub's Wiki > pages? > > > If people have a strong preference to keep the design docs on Google > > Docs, > > > then could we have a top-level page on the confluence wiki that lists > all > > > active and archived design docs? > > > > > > Punya > > > > > >
