[DISCUSS] Reviewing design documents

2014-03-27 Thread Keith Turner
I would really like to review the design doc posted on ACCUMULO-378, but I would rather not do that on Google docs. I would like to use Apache infrastructure and have the discussion around the design doc archived in the mailing list. One option is to use Markdown + RB and never check the design d

Re: [DISCUSS] Reviewing design documents

2014-04-04 Thread Al Krinker
+1 for Gerrit. I have experience with it so let me know if you need my help. On Fri, Mar 28, 2014 at 9:39 AM, Keith Turner wrote: > On Fri, Mar 28, 2014 at 12:23 AM, Sean Busbey >wrote: > > > Aside from the occasional stability problem, I really like the idea of > > using ReviewBoard. It has t

Re: [DISCUSS] Reviewing design documents

2014-04-04 Thread Josh Elser
On 3/28/14, 9:39 AM, Keith Turner wrote: On Fri, Mar 28, 2014 at 12:23 AM, Sean Busbeywrote: >Aside from the occasional stability problem, I really like the idea of >using ReviewBoard. It has the best option for in-context commenting amongst >our options at Apache AFAICT. > Another plus is tha

Re: [DISCUSS] Reviewing design documents

2014-04-04 Thread Keith Turner
Why not have the design doc in markdown only? I assume its not expressive enough? For the ACCUMULO-1000 design doc I used asciidoc to try that out.The asciidoc source was readable like markdown and maybe more expressive than markdown On Fri, Apr 4, 2014 at 12:45 PM, Josh Elser wrote: > On

Re: [DISCUSS] Reviewing design documents

2014-04-04 Thread Alex Moundalexis
On Fri, Apr 4, 2014 at 12:45 PM, Josh Elser wrote: > > The localized commenting on reviewboard is nice, but making updates to the > document is definitely not fun. > Why not use GitHub? it provides most of what you're using RB for now, but: - Markdown is easily edited/previewed on GitHub - pull

Re: [DISCUSS] Reviewing design documents

2014-04-04 Thread Keith Turner
On Fri, Apr 4, 2014 at 1:40 PM, Alex Moundalexis wrote: > On Fri, Apr 4, 2014 at 12:45 PM, Josh Elser wrote: > > > > The localized commenting on reviewboard is nice, but making updates to > the > > document is definitely not fun. > > > > Why not use GitHub? it provides most of what you're using R

Re: [DISCUSS] Reviewing design documents

2014-04-04 Thread Josh Elser
Granted, the syntax is probably expressive enough to read, but viewing it in plaintext isn't the same as having it "rendered". The lack of varying font size is probably the most noticeable problem. Trying to read a table in raw markdown is also a good example. Code snippets also are difficult

Re: [DISCUSS] Reviewing design documents

2014-04-04 Thread Sean Busbey
On Fri, Apr 4, 2014 at 12:49 PM, Keith Turner wrote: > On Fri, Apr 4, 2014 at 1:40 PM, Alex Moundalexis >wrote: > > > On Fri, Apr 4, 2014 at 12:45 PM, Josh Elser > wrote: > > > > > > The localized commenting on reviewboard is nice, but making updates to > > the > > > document is definitely not

Re: [DISCUSS] Reviewing design documents

2014-04-04 Thread Keith Turner
On Fri, Apr 4, 2014 at 1:49 PM, Josh Elser wrote: > Granted, the syntax is probably expressive enough to read, but viewing it > in plaintext isn't the same as having it "rendered". > > The lack of varying font size is probably the most noticeable problem. > Trying to read a table in raw markdown

Re: [DISCUSS] Reviewing design documents

2014-04-04 Thread Josh Elser
On 4/4/14, 2:09 PM, Keith Turner wrote: On Fri, Apr 4, 2014 at 1:49 PM, Josh Elser wrote: >Granted, the syntax is probably expressive enough to read, but viewing it >in plaintext isn't the same as having it "rendered". > >The lack of varying font size is probably the most noticeable problem. >

Re: [DISCUSS] Reviewing design documents

2014-03-27 Thread Mike Drob
I've seen other projects upload a file to the appropriate JIRA and that seemed to work well. I don't have specific experience with that, though, so I cannot warn you about any pitfalls. On Thu, Mar 27, 2014 at 6:05 PM, Keith Turner wrote: > I would really like to review the design doc posted on

Re: [DISCUSS] Reviewing design documents

2014-03-27 Thread Bill Havanki
Another idea: Use a wiki? We could establish an area beneath the Hadoop wiki [1]. [1] http://wiki.apache.org/hadoop/ On Thu, Mar 27, 2014 at 7:02 PM, Mike Drob wrote: > I've seen other projects upload a file to the appropriate JIRA and that > seemed to work well. I don't have specific experien

Re: [DISCUSS] Reviewing design documents

2014-03-27 Thread Josh Elser
There's also the confluence wiki that we could get space on, I think. A wiki isn't very well suited to making inline comments though (unless we break up the design doc into individual wiki pages... hmm). On 3/27/14, 5:06 PM, Bill Havanki wrote: Another idea: Use a wiki? We could establish an

Re: [DISCUSS] Reviewing design documents

2014-03-27 Thread Sean Busbey
Aside from the occasional stability problem, I really like the idea of using ReviewBoard. It has the best option for in-context commenting amongst our options at Apache AFAICT. I think the finished doc (preferably in markdown) could just be attached to the jira that's relevant. I'd like to see a p

Re: [DISCUSS] Reviewing design documents

2014-03-28 Thread Keith Turner
On Fri, Mar 28, 2014 at 12:23 AM, Sean Busbey wrote: > Aside from the occasional stability problem, I really like the idea of > using ReviewBoard. It has the best option for in-context commenting amongst > our options at Apache AFAICT. > Another plus is that the inline discussion threads go w/ a

Re: [DISCUSS] Reviewing design documents

2014-03-28 Thread Bill Havanki
Could this be a good test case for Gerrit? On Fri, Mar 28, 2014 at 12:23 AM, Sean Busbey wrote: > Aside from the occasional stability problem, I really like the idea of > using ReviewBoard. It has the best option for in-context commenting amongst > our options at Apache AFAICT. > > I think the f