[Bese-devel] patches for UCW and some questions for ucw-core

[burban at opopop.net]

Clinton Ebadi <clinton at unknownlamer.org> writes:

> burban at opopop.net writes:
> 
> >> (we'll advertise it more once we have a more useful demo built on it
> >> and it get its own standalone project page)
> >
> > Some documentation would be nice also. UCW suffers from a
> > documentation too terse to go easily beyond the basics.
> 
> src/rerl/protocol.lisp is actually *very* good documentation for UCW. A
> quick browse of it will give you more or less all of the knowledge
> required to extend UCW.

True. But for a newcomer to UCW, this is of little help to understand
it for performing simple tasks. 
 
> The source of ucw-core/ucw-standard is generally well annotated with
> docstrings--the only thing I can think of to improve the accessibility
> of the documentation would be to generate a qbook (or similar) html doc
> from the source.

True also, but same problem as above.

> If you disagree, suggestions are welcome and I'll look into working
> patches to fix things.
> 

See my reply to Attila about documentation. The path so far
followed by the ucw-core manual seems fine to me.

Regards.

-- 

B. Urban