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/). I really don't want to use SGML or XML. -- Dave Page Blog: http://pgsnake.blogspot.com Twitter: @pgsnake EnterpriseDB UK: http://www.enterprisedb.com The Enterprise Postgres Company -- Sent via pgadmin-hackers mailing list ([email protected]) To make changes to your subscription: http://www.postgresql.org/mailpref/pgadmin-hackers
