Mailing-List: contact dev-help@couchdb.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@couchdb.apache.org
Received-SPF: pass (nike.apache.org: domain of simon@cloudant.com designates
 209.85.212.182 as permitted sender)
Date: Thu, 21 Jun 2012 16:25:46 +0100
From: Simon Metson <simon@cloudant.com>
To: dev@couchdb.apache.org
Message-ID: <FF69394627DB40C0BFE9CBC7AE253631@cloudant.com>
In-Reply-To: <436CC93B-6244-4A01-9933-46B2937AB331@apache.org>
References: <EC73BB16-F86A-4F6B-9143-A22B88381108@apache.org>
 <8A69B3F1-C955-4127-B92B-B0DA1AA9AEB6@apache.org>
 <19EB8367-1282-4406-9C51-B3AE4AFA0080@apache.org>
 <D5FEC7AA-2294-41F5-81E9-AF982BF29976@apache.org>
 <2E5C3210-58B9-48A7-9E21-3B6206D24899@apache.org>
 <382956416E9B4787895A95D59AC5ECC1@cloudant.com>
 <70658AB3-81FA-4E3A-ABE6-D6299ED2704A@apache.org>
 <E2D5A5F1B3794024BBEC5AD03852711F@cloudant.com>
 <436CC93B-6244-4A01-9933-46B2937AB331@apache.org>
Subject: Re: Docs, second try
MIME-Version: 1.0
Content-Type: multipart/alternative; boundary="4fe33cfa_1d91467c_1265d"

--4fe33cfa_1d91467c_1265d
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: quoted-printable
Content-Disposition: inline

Hi,
> This has nothing to do with docbook, we generate HTML and we can link t=
o that in =46uton, I don't think we want to generate the =46uton-docs par=
t in docbook, but happy to be proven wrong. I think it'd be easer to make=
 a docs.html in futon that keeps the header and sidebar and just shows th=
e /=5Fdocs/... link.
 I'm probably just showing how little I know about docbook ;) (not helped=
 by their documentation wiki being down currently=E2=80=A6). If this was =
sphinx I'd write a theme that would be applied to all the generated html,=
 making it easy to plug into futon (or style for other purposes). I'm ass=
uming we could do the same thing with docbook, though putting the generat=
ed content in an iframe is probably quicker (and is what I've just done).=

> =20
> > What about things like pulling in Dale's jquery.couch.js docs (daleha=
rvey.github.com/jquery.couch.js-docs/symbols/index.html)=3F (http://daleh=
arvey.github.com/jquery.couch.js-docs/symbols/index.html)=3F)
> =20
> =20
> We should definitely consider this, but I think that is out of scope fo=
r this particular patch.
Agreed, just thinking ahead a bit.
Cheers
Simon =20

--4fe33cfa_1d91467c_1265d--