Mailing-List: contact dev-help@couchdb.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@couchdb.apache.org
Received-SPF: error (nike.apache.org: local policy)
Content-Type: text/plain; charset=us-ascii
Mime-Version: 1.0 (Apple Message framework v1283)
Subject: Re: [REVIEW] Docs update
From: Filippo Fadda <filippo.fadda@programmazione.it>
In-Reply-To: 
 <CAHdjip+FP_bChDMuszYVUQBNkKdxyaGOt-w6KiurKFQ81kFWUw@mail.gmail.com>
Date: Fri, 9 Aug 2013 16:04:44 +0200
Content-Transfer-Encoding: quoted-printable
Message-Id: <CBAA03A5-4039-488F-869B-0F510CD54A21@programmazione.it>
References: 
 <CAHdjipJwktCD9cHkQx0vQObNxVFB+1RP3i35jKkP_56+TCs8Hg@mail.gmail.com>
 <3923359E-7F63-4DDE-9CDE-BFF070FA4CCD@programmazione.it>
 <CAHdjipKefuDdguiE8WcpiJBhs2A0A-S6CRv_aG1JVTKb_HsuvQ@mail.gmail.com>
 <BB22AF6F-74EB-4207-893A-86B76A88A09A@programmazione.it>
 <CAHdjipLJaiO3HhodG5F9gHsr-ADumf=41KwgcfSUahUc9mmPOA@mail.gmail.com>
 <57BD5EEF-B25E-42E5-8EAA-DAFFABDE5CF9@programmazione.it>
 <CAPaJBx4zSB8sGU-5egduJQDGCObyKRAGWKzbzo_gx+w2fg2feQ@mail.gmail.com>
 <200505FF-D557-4045-A6E1-EC655B63A1FA@programmazione.it>
 <CAL+Y1nsYS9FY83AG+7tw5Tv3xH1EVvrYEneeukF9V22trJKhrA@mail.gmail.com>
 <CAHdjip+FP_bChDMuszYVUQBNkKdxyaGOt-w6KiurKFQ81kFWUw@mail.gmail.com>
To: dev@couchdb.apache.org

Done.

I don't know much about Homebrew, but it seems to me that you don't need =
all the steps described to install CouchDB from brew.
Someone should also revise the Homebrew section.

Actually the Installation of "Unix-like systems" is full of "you are =
driving me crazy" things.
I didn't try, but I'm pretty sure to install on RedHat, CentOS, Fedora =
you just need "yum install couchdb" like "apt-get install couchdb" on =
Debian style distro like Ubuntu. Let's apply the KIS principle, even to =
the documentation.

It's OK having a detailed section that list all the dependencies but =
that's something, probably, used only by developers or people having =
troubles on their systems. So, also the UNIX section should be revised =
with the minimum required steps to install CouchDB on the various =
distro.
All the Unix stuff should be moved to "Install from source" section, =
where find all the dependencies you need to compile CouchDB, tips and =
tricks, etc.=20

-Filippo

On Aug 9, 2013, at 11:10 AM, Alexander Shorin wrote:

> On Fri, Aug 9, 2013 at 12:27 PM, Dave Cottlehuber <dch@jsonified.com> =
wrote:
>>> I agree, dmg is the first choice for everyone, but if CouchDB is =
available through MacPorts, Fink, Homebrew or even Rudix who do not =
mention them?
>>=20
>> +1. Let's make it as easy as pie to get on the couch.
>>=20
>> Filippo, would you like to send in a patch to update these?
>> https://github.com/apache/couchdb/tree/master/share/doc/src and =
how-to
>> is here =
https://github.com/apache/couchdb/blob/master/share/doc/src/contributing.r=
st
>> should cover how to do this.
>>=20
>=20
> Better to send it against:
> =
https://github.com/apache/couchdb/tree/1781-reorganize-and-improve-docs/sh=
are/doc/src
>=20
> There is special article about Mac installation, so it would be easy
> to concentrate on the problem to provide better content.
> Also, while you're reading docs at my local mirror, you may hit "Edit
> on GitHub" button to quick send PR with fixes.
>=20
> Hope to finish some few base things till 1.4 votes (thanks for Dirkjan
> vacations, it's not too late for docs updates, right?) before merge
> it.
>=20
> --
> ,,,^..^,,,