Message-ID: <1985.209.198.116.24.1074351327.squirrel@www.derxis.com>
In-Reply-To: <200401162322.04719.xzilla@users.sourceforge.net>
References: <03AF4E498C591348A42FC93DEA9661B87204CA@mail.vale-housing.co.uk>
	<200401161409.57247.josh@agliodbs.com>
	<20040116181616.X13900@ganymede.hub.org>
	<200401162322.04719.xzilla@users.sourceforge.net>
Date: Sat, 17 Jan 2004 09:55:27 -0500 (EST)
Subject: Re: techdocs/v2 and Bricolage
From: "Steve Simms" <steve@deefs.net>
To: "Robert Treat" <xzilla@users.sourceforge.net>
Cc: "Marc G. Fournier" <scrappy@postgresql.org>,
	"Josh Berkus" <josh@agliodbs.com>, "Dave Page" <dpage@vale-housing.co.uk>,
	"PostgreSQL Web Development Mailing List" <pgsql-www@postgresql.org>
User-Agent: SquirrelMail/1.4.1-2
MIME-Version: 1.0
Content-Type: text/plain;charset=iso-8859-1
Content-Transfer-Encoding: 8bit
Importance: Normal

Robert Treat said:
> On Friday 16 January 2004 17:16, Marc G. Fournier wrote:
>> On Fri, 16 Jan 2004, Josh Berkus wrote:
>> > Dave,
>> >
>> > > The only really noticable speed issues I saw whilst playing were local
>> > > network issues. I editted one page and it certainly wasn't noticably
>> > > slower than our other php admin interface.

The site seems a little slow to me -- it took five seconds to bring up the
home page, compared to two for the postgresql.org home page.  Not terrible,
but noticeable.

>> > OK.   Do we want to give it a try?  I would eliminate one item I've been
>> > procrastinating on for some time, and I'd be happy to relieve Robert of
>> > any Techdocs maint based on Plone.

The structured text aspect of plone seems to be a bit iffy to me.  In
particular, it looks like there's a *lot* of indenting involved based on their
description of it (http://plone.org/documentation/book/10).

Other concerns:

- Inline preformatted text is done with apostrophes.  This seems prone to
accidents, particularly if you try to use SQL inline.

- It *looks* like you can only do preformatted text if the preceding paragraph
ends in a colon (which needs to be doubled).

- It replaces HTML with another formatting language.  It attempts to be
simpler, but I'm not sure if it succeeds.

A good test would be to take an article that has a fair number of SQL examples
in it, and port it to plone's format.  If this were done by someone who's
already written articles (and might do so again) -- I'm thinking of Josh, that
would be particularly helpful.

>> 'k, is this replacing techdocs, or just part of techdocs?
>
> If we're going to do it, we need to replace the whole thing IMO.

I agree.  We don't need to add another method of storage/delivery if we can
avoid it.

As of last night, I have Bricolage installed on a server, and am now
attempting to figure out how to use it (not very obvious).  As far as I can
tell, it publishes plain HTML to any number of servers, without needing
anything special running on the destination web server, so it'll be hard to
beat that for speed.  It also allows for writing, editing, approving and
publishing as separate steps (the last two might be combined).