[cl-typesetting-devel] Re: [cl-pdf-devel] Cl typesetting and cl-pdfdocumentation creation

[Marc Battyani]

Arthur Lemmens wrote:

> Brian Sorg wrote:
>
> > I am fairly new to the cl-pdf and cl-typesetting software and have
> > decided that as I learn how to use it, I would take the time to
> > document what I discover so that others could benefit as well.
>
> Great.
>
> > On Marc Battyani's suggestion I am contacting the entire group to see
> > if others have recommendations on the structure/format/method of
creation
> > that the documentation should take.
>
> My recommendation would be not to bother with "structure/format/method
> of creation" at all and just get started. Any documentation, even if it's
> just a plain old text file, is better than no documentation at all. Once
> you have written down enough documentation that meta-issues like structure
> and format become relevant, you'll be in a much better position to make
> an informed decision about such issues.

I agree with that. A documentation in a bad format is better than no docs in
a nice format ;-)
Though of course it would be better to use a format that can be converted
to/processed by cl-typesetting. So if anybody already have some kind of user
friendly syntax that could be used please raise your hand!

Marc