I'd like to get a vote by the contributors on which approach to use.
I'll start the voting:

A) +1 because I don't know how much information might be needed and
the information might change for different versions of Accumulo. Also
the README might wind up with many OS-specific sections. And, lastly
because I've already done it. :)

  Neither. Looking over the README, it contains information for developers
and users. So, we have a README, user and developer manuals, and a wiki.
This information is clearly for developers, maybe it should go in the
developer manual or on the web site in the developer guide section[1].  

  It almost seems as if there are too many documents. Maybe get rid of the
README, and instead have a CHANGES document that details the differences
between releases. Then, in addition, have a user and developer manual in the
distribution, and make those document also available from the web site.
Three documents instead of four, each having their own distinct purpose.

[1] http://accumulo.apache.org/source.html

Dave

-----Original Message-----
From: David Medinets [mailto:[EMAIL PROTECTED]]
Sent: Thursday, July 26, 2012 7:17 PM
To: accumulo-dev
Subject: Vote For A) README_UBUNTU B) "Compiling on Ubuntu" In README

I'd like to get a vote by the contributors on which approach to use.
I'll start the voting:

A) +1 because I don't know how much information might be needed and the
information might change for different versions of Accumulo. Also the README
might wind up with many OS-specific sections. And, lastly because I've
already done it. :)

One concern I have is clutering the top level Accumulo dir.  We do not
have to put the ubunutu information in the README to avoid this.
Another option is moving the file to the docs dir or some of the
suggestions that Dave Marion made.

On Thu, Jul 26, 2012 at 7:16 PM, David Medinets
<[EMAIL PROTECTED]> wrote:
> I'd like to get a vote by the contributors on which approach to use.
> I'll start the voting:
>
> A) +1 because I don't know how much information might be needed and
> the information might change for different versions of Accumulo. Also
> the README might wind up with many OS-specific sections. And, lastly
> because I've already done it. :)

Neither

Like Keith said, I'm not a fan of clustering documentation at the top
level, especially linux distribution specific readmes. Accumulo is
agnostic of the target flavor of linux, as such it doesn't make sense to
keep such guidance beside the source code. As Dave said, I also agree
that the user/developer manual doesn't make sense. I like the current
top-level README. Succinct enough to not drive people away, and gives
the necessary basic information to get up and running.

I think adding Ubuntu specific information to the accumulo.apache.org
site would be a good place to host this kind of information. You could
easily add a section which includes linux distribution specifics/quirks.

On 07/27/2012 11:32 AM, Keith Turner wrote:
> One concern I have is clutering the top level Accumulo dir.  We do not
> have to put the ubunutu information in the README to avoid this.
> Another option is moving the file to the docs dir or some of the
> suggestions that Dave Marion made.
>
> On Thu, Jul 26, 2012 at 7:16 PM, David Medinets
> <[EMAIL PROTECTED]>  wrote:
>> I'd like to get a vote by the contributors on which approach to use.
>> I'll start the voting:
>>
>> A) +1 because I don't know how much information might be needed and
>> the information might change for different versions of Accumulo. Also
>> the README might wind up with many OS-specific sections. And, lastly
>> because I've already done it. :)

Dave,

Would you be opposed to moving the ubunutu document to the docs dir?
Once its there we can add a link to it in svn from the Accumulo
developer web page.

Also I think the "snv co" instructions should reference a released
verion of Thrift, not the branch.  This can accomplished by
referencing a tag or a download of a release source tar ball.

So could do the following

svn co http://svn.apache.org/repos/asf/thrift/tags/thrift-0.8.0/

What do you think?

Also, can you include in the instructions what version of Ubuntu the
instructions were tested against?  e.g.  12.04 x86_64

Do you know if the native Accumulo libraries build successfully when
you follow these instructions? The makefile tries to build 32 bit and
64 bit shared libraries, sometimes this fails on a 64 bit redhat
system unless 32 bit libraries are installed.

Thanks,

Keith

On Wed, Aug 1, 2012 at 9:36 PM, Josh Elser <[EMAIL PROTECTED]> wrote:
> Neither
>
> Like Keith said, I'm not a fan of clustering documentation at the top level,
> especially linux distribution specific readmes. Accumulo is agnostic of the
> target flavor of linux, as such it doesn't make sense to keep such guidance
> beside the source code. As Dave said, I also agree that the user/developer
> manual doesn't make sense. I like the current top-level README. Succinct
> enough to not drive people away, and gives the necessary basic information
> to get up and running.
>
> I think adding Ubuntu specific information to the accumulo.apache.org site
> would be a good place to host this kind of information. You could easily add
> a section which includes linux distribution specifics/quirks.
>
>
> On 07/27/2012 11:32 AM, Keith Turner wrote:
>>
>> One concern I have is clutering the top level Accumulo dir.  We do not
>> have to put the ubunutu information in the README to avoid this.
>> Another option is moving the file to the docs dir or some of the
>> suggestions that Dave Marion made.
>>
>> On Thu, Jul 26, 2012 at 7:16 PM, David Medinets
>> <[EMAIL PROTECTED]>  wrote:
>>>
>>> I'd like to get a vote by the contributors on which approach to use.
>>> I'll start the voting:
>>>
>>> A) +1 because I don't know how much information might be needed and
>>> the information might change for different versions of Accumulo. Also
>>> the README might wind up with many OS-specific sections. And, lastly
>>> because I've already done it. :)

No. I'll try to do this tomorrow if nobody does it first.

On Thu, Aug 2, 2012 at 11:02 AM, Keith Turner <[EMAIL PROTECTED]> wrote:
> Dave,
>
> Would you be opposed to moving the ubunutu document to the docs dir?
> Once its there we can add a link to it in svn from the Accumulo
> developer web page.
>
> Also I think the "snv co" instructions should reference a released
> verion of Thrift, not the branch.  This can accomplished by
> referencing a tag or a download of a release source tar ball.
>
> So could do the following
>
> svn co http://svn.apache.org/repos/asf/thrift/tags/thrift-0.8.0/
>
> What do you think?
>
> Also, can you include in the instructions what version of Ubuntu the
> instructions were tested against?  e.g.  12.04 x86_64
>
> Do you know if the native Accumulo libraries build successfully when
> you follow these instructions? The makefile tries to build 32 bit and
> 64 bit shared libraries, sometimes this fails on a 64 bit redhat
> system unless 32 bit libraries are installed.
>
> Thanks,
>
> Keith
>
> On Wed, Aug 1, 2012 at 9:36 PM, Josh Elser <[EMAIL PROTECTED]> wrote:
>> Neither
>>
>> Like Keith said, I'm not a fan of clustering documentation at the top level,
>> especially linux distribution specific readmes. Accumulo is agnostic of the
>> target flavor of linux, as such it doesn't make sense to keep such guidance
>> beside the source code. As Dave said, I also agree that the user/developer
>> manual doesn't make sense. I like the current top-level README. Succinct
>> enough to not drive people away, and gives the necessary basic information
>> to get up and running.
>>
>> I think adding Ubuntu specific information to the accumulo.apache.org site
>> would be a good place to host this kind of information. You could easily add
>> a section which includes linux distribution specifics/quirks.
>>
>>
>> On 07/27/2012 11:32 AM, Keith Turner wrote:
>>>
>>> One concern I have is clutering the top level Accumulo dir.  We do not
>>> have to put the ubunutu information in the README to avoid this.
>>> Another option is moving the file to the docs dir or some of the
>>> suggestions that Dave Marion made.
>>>
>>> On Thu, Jul 26, 2012 at 7:16 PM, David Medinets
>>> <[EMAIL PROTECTED]>  wrote:
>>>>
>>>> I'd like to get a vote by the contributors on which approach to use.
>>>> I'll start the voting:
>>>>
>>>> A) +1 because I don't know how much information might be needed and
>>>> the information might change for different versions of Accumulo. Also
>>>> the README might wind up with many OS-specific sections. And, lastly
>>>> because I've already done it. :)