[wsf-c-dev] APIs cannot be left to the last minute

[James Clark]

I'm concerned that we are just starting discussion of APIs for
functionality that is supposed to go into a release that is days away.

Since we are creating a library, the APIs are the most fundamental
aspect of our product.  It is not satisfactory just to hack away and
then propose an API when you're nearly done.  Any public API needs to be
documented, discussed and agreed well in advance, before implementation
starts.  By documented, I don't just mean there's a list of the names of
functions; the semantics need to be fully described as well.

At the moment we should probably just focus on the PHP APIs.  But at
some point we are going to need to get serious about our C API as well.

James