[REBOL] Re: Comments about make-doc-pro?
From: dness:home at: 8-Aug-2001 14:05
Ladislav Mecir wrote:
> > Hi, I hope that some of you had a look at the make-doc-pro script and
> played
> > around with it a bit. Any comments? Robert
>
> Hi,
>
> I like the idea and I am using the make-doc. The simplicity is appealing.
> But the "dialect" used to specify the document is a little bit "irrebolar"
> IMO.
> I would like to have it a little bit more "rebolar" as follows:
>
> instead of saying:
>
> ===Objective
>
> I'd prefer to say:
>
> [section] Objective
>
> Instead of saying:
>
> ---Primary Rule
>
> I'd prefer
>
> [subsection] Primary Rule
>
...
> What do you think?
>
I've played around with make-doc (not yet with make-doc-pro, which
I should be getting to later today) and I'd _disagree_ fairly strongly
with these suggestions. It seems to me that they not only generally require
_more_ typing, but also are more prone to misspelling, and thus extra
error/correction cycles, during document preparation.
Of course, I guess I wouldn't ultimately object to just about anything that could
be done/undone with a simple set of perl substitutions, so I don't feel strongly
about it, but I do prefer the current way of marking up simple text.