Re: Time for a new release?

On Jan 17, 2009, at 2:24 AM, Marco Maggi wrote:
> In the process of testing the foreign
> functions interface callback features
> of a set of Scheme language implementations,
> I have started a binding to Expat.

Wonderful!  What Scheme implementations are you supporting?

> The first thing I noticed is that the
> documentation is in bad shape.  This is
> a real problem for me, so I started by
> reformatting it to Texinfo[1].

Why Texinfo?  I'm a little surprised that's used any more.

There are two separate concerns here:

1. Format (HTML v. Texinfo v. anything else).

2. Content.

I'd rather separate those concerns; whatever content changes should be  
made to the current format, and a format conversion should be  
considered on it's own merits.

I'm not opposed to changing the documentation format, but I am opposed  
to changing it without planning.  I think it's also important that  
there be only one format.


   -Fred

-- 
Fred Drake   <fdrake at acm.org>