incubator-couchdb-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Noah Slater <nsla...@apache.org>
Subject Re: [REVIEW] Docs update
Date Mon, 12 Aug 2013 01:57:53 GMT
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

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message