Re: Windows CHM format for the documents

From: Christopher Browne <cbbrowne(at)acm(dot)org>
To: pgsql-docs(at)postgresql(dot)org
Subject: Re: Windows CHM format for the documents
Date: 2003-09-10 20:33:37
Message-ID: m3brtswfha.fsf@chvatal.cbbrowne.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-hackers-win32

ilkka(at)visiomode(dot)com wrote:
> I'm not sure if it would be a bad thing to give up DocBook, but I cannot see
> anything but benefits from using this other type of document development...

I cannot see anything but problems from using this.

- The current usage allows people to work on documents as files, using
whatever editing tools they like. With your "server software," that
is lost.

- Current usage uses CVS to manage changes. This allows changes to be
looked at and approved/rejected/modified. I haven't any idea if
your system uses text files in behind, it sounds like not.

- Current usage does not mandate that anyone have a synchronous
connection to a central server that becomes bottleneck / vulnerable
point.

The apparent "benefit" of your tool is that it provides a tool with a
user interface that slavishly follows the Windows "CHM file" viewer.
That may be an advantage to those that want to slavishly follow
Windows development/deployment "standards," but I daresay you're NOT
in a community that is particularly interested in that sort of thing.
--
wm(X,Y):-write(X),write('@'),write(Y). wm('aa454','freenet.carleton.ca').
http://www3.sympatico.ca/cbbrowne/nonrdbms.html
Sturgeon's Law: 90% of *EVERYTHING* is crud.

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Bruce Momjian 2003-09-11 17:31:58 Re: minor documentation improvements
Previous Message Bruce Momjian 2003-09-10 20:05:01 Re: [PATCHES] minor documentation improvements

Browse pgsql-hackers-win32 by date

  From Date Subject
Next Message Christof Petig 2003-09-11 07:11:33 Re: pgsql-server/src backend/bootstrap/Tag: backen ...
Previous Message ilkka 2003-09-10 18:30:36 Re: Windows CHM format for the documents