On Fri, Sep 24, 2010 at 11:16, Guillaume Lelarge <[email protected]> wrote: > Le 24/09/2010 10:39, Dave Page a écrit : >> On Fri, Sep 24, 2010 at 9:29 AM, Guillaume Lelarge >> <[email protected]> wrote: >>> Documentation for pgAdmin is really weak right now. Just to take an >>> example, I don't know where a plugin file is described. >>> >>> The real question is how we do this. Right now, the documentation is a >>> set of HTML files. Which is fine for some people and not for others. >>> Kind of hard to get a consistent style. Kind of hard to get a good PDF >>> and CHM file out of it. Not sure we really need these formats, I'm sure >>> we want a consistent style. >>> >>> The only way to get all these options, AFAICT, is to use Docbook. SGML >>> or XML. I have no problem working with Docbook, but I'm not sure >>> everyone feels the same. I really prefer XML because of the toolset we >>> can use (which seems, at least to me, in much better shape than the SGML >>> one). >>> >>> Anyone has better ideas? >> >> Yeah, I was looking at this the other day, but ran out of time. >> Looking at using Sphinx (http://sphinx.pocoo.org/). >> > > Seems interesting. Just at the same time, we (Dalibo) get rid of our > documents in ReST format, so I'll still have to work with it for pgadmin :-/
Why do you get rid of ReST, and what are you changing to? -- Magnus Hagander Me: http://www.hagander.net/ Work: http://www.redpill-linpro.com/ -- Sent via pgadmin-hackers mailing list ([email protected]) To make changes to your subscription: http://www.postgresql.org/mailpref/pgadmin-hackers
