Mailing-List: contact dev-help@couchdb.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@couchdb.apache.org
MIME-Version: 1.0
In-Reply-To: <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>
	<CBAA03A5-4039-488F-869B-0F510CD54A21@programmazione.it>
Date: Mon, 12 Aug 2013 02:57:53 +0100
Message-ID: 
 <CAPaJBx5M+LTvGV=KfdmsA0VdRAjcD4Uag2hS0zofJAtHws_vrA@mail.gmail.com>
Subject: Re: [REVIEW] Docs update
From: Noah Slater <nslater@apache.org>
To: "dev@couchdb.apache.org" <dev@couchdb.apache.org>
Content-Type: multipart/alternative; boundary=f46d0438952dd45fef04e3b67343

--f46d0438952dd45fef04e3b67343
Content-Type: text/plain; charset=ISO-8859-1

I like the idea of all the complex stuff being moved to an "Install from
source" section, which is kept as the last thing we mention.

Alexander, I think you still have time to work on the docs before Dirkjan
is back, yep!


On 9 August 2013 15:04, Filippo Fadda <filippo.fadda@programmazione.it>wrote:

> 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.
>
> -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?
> >>
> >> +1. Let's make it as easy as pie to get on the couch.
> >>
> >> 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.rst
> >> should cover how to do this.
> >>
> >
> > Better to send it against:
> >
> https://github.com/apache/couchdb/tree/1781-reorganize-and-improve-docs/share/doc/src
> >
> > 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.
> >
> > 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.
> >
> > --
> > ,,,^..^,,,
>
>


-- 
Noah Slater
https://twitter.com/nslater

--f46d0438952dd45fef04e3b67343--