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 <[email protected]>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 <[email protected]> > 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
