Mailing-List: contact dev-help@couchdb.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@couchdb.apache.org
Received-SPF: neutral (nike.apache.org: local policy)
Content-Type: text/plain; charset=windows-1252
Mime-Version: 1.0 (Apple Message framework v1278)
Subject: Re: Docs, second try
From: Jan Lehnardt <jan@apache.org>
In-Reply-To: <8A69B3F1-C955-4127-B92B-B0DA1AA9AEB6@apache.org>
Date: Sun, 17 Jun 2012 12:47:19 +0200
Content-Transfer-Encoding: quoted-printable
Message-Id: <19EB8367-1282-4406-9C51-B3AE4AFA0080@apache.org>
References: <EC73BB16-F86A-4F6B-9143-A22B88381108@apache.org>
 <8A69B3F1-C955-4127-B92B-B0DA1AA9AEB6@apache.org>
To: dev@couchdb.apache.org


On Jun 17, 2012, at 12:12 , Jan Lehnardt wrote:

> Same repo, some news:
>=20
> - updated NOTICE
> - added minimal css styling to make it not look ass
> - made make distcheck pass* (wooo!)
> - linked the per-chapter build in Futon instead of the full-page.**
>=20
> As far as I can see, this is good to go into master.

Well, one more thing=99: I need to hook this up to `make install`.
I'll try and do this right away.

Cheers
Jan
--=20


>=20
> There's plenty of room for improvement:
>=20
> - better integration into Futon
> - more approachable ToC (expandable sub-levels, e.g.)
> - better styling
> - more docs :)
>=20
> Let us know if you want to help out with this!
>=20
> Cheers
> Jan
> --
>=20
> * Noah, could you have a look at my license.skip commit and tell me
> I'm not doing anything fishy?
>=20
>  =
https://github.com/janl/couchdb/commit/56b664854209e00d0ff549352970abd269a=
db24b
>=20
> ** The last commit I had to rebase to keep the history nice, that =
means
> the branch had to be pushed with -f. This is only relevant if you have
> checked out the branch in the past and made edits to it.
>=20
> On Jun 11, 2012, at 22:05 , Jan Lehnardt wrote:
>=20
>> Hey all,
>>=20
>> remember that big commit I made to a new docs branch with all
>> the .jar files in it and whatnot? Well, I've cleaned it up and
>> pushed it to GitHub:
>>=20
>> https://github.com/janl/couchdb/tree/docs
>>=20
>> The README states all prerequisites.
>>=20
>> I have ripped all the .jar files out of the repo and put them
>> in a .tgz up on:
>>=20
>> http://people.apache.org/~jan/couchdb/couchdb-doc-jars.tgz
>>=20
>> To build the docs go to share/docs and run
>>=20
>> $ COUCHDB_DOC_JAR_DIR=3D/path/to/doc/jars make docs
>>=20
>> This is the easiest I could think of for pushing this forward.
>>=20
>> I also went through all the other resources in the share/docs
>> directory and double checked the licensing on all items and
>> couldn't find anything incompatible. I've still to update
>> the NOTICE file to make this land on ASF infrastructure, but
>> I think we are in a good position.
>>=20
>> Please check out the branch and give us any feedback, I'd like
>> to finally finally get this merged soon :)
>>=20
>> Cheers
>> Jan
>> --=20
>>=20
>=20