Re: SWAG: Redfoot 0.9.9 Released

Why do you think I said "sadly"? :-)

I agree. Both documentation and *tests* should be part of the design process
from the beginning.

We were relatively well behaved when it came to tests preceding code. Design
documentation does exist and will contribute to the developer documentation
that we make available over the next few weeks.

Actually, I would have liked to have done more with literate programming
(anyone for RDF-based literate programming?)

We're striving to improve.

Of course, in a perfect world, Dan and I would be working on Redfoot
fulltime rather than a few hours here and there, releasing at 3am :-)

James

PS authoring tools are coming - we wanted to gain more experience in
building apps using the language first

> >Documentation is sadly lacking
>
> I don't want to chide someone on the lists for so common a "mistake" but
> this is a place where we all fail miserably. Just as "Accessibility" is
> almost always an "afterthought add-on" so is "documentation".
>
> In other posts I claim that documentation (and authoring tools for newly
> designed languages as well) should precede or at least accompany all steps
> in a design process.
>
> I just don't know what to do about this except perhaps start a religious
> order in which members take solemn vows to "do right"!

Received on Wednesday, 15 August 2001 03:26:27 UTC