[Image-SIG] New PIL release

Eric S. Raymond esr@snark.thyrsus.com
Sun, 19 Jul 1998 13:53:40 -0400

Fredrik Lundh <fredrik@pythonware.com>:
> Did you grab the 0.3b2 release just after you received the
> announcement?  If you were unlucky, you might have gotten
> a file called "Imaging-0.3b1.tgz"...

That's what happened.
> If you try again, you should get the right file...

Will do.
> >Still no pilfont docs; the link on the handbook page is broken.
> >
> >Why isn't the documentation included with the source distribution?
> It will be in the final release, once it's up to date.

Please push the docs higher on your priority list.  The pildriver
script is getting mature enough that the gaps in the documentation
are now a serious impediment to its further development.

Also, I have observed in the past that when the documentation is left
until last, it tends to get left unfinished and be of poor quality.
Even very good developers (which it's clear you are) often fall into
this trap under pressure to dive into the next project.

For this reason, I often document my projects *before* coding, as I
design them in my head.  (For an example, see the Trove design document
at <http://www.tuxedo.org/~esr/trove>.)  This is a practice I recommend
to you.

I think you would be doing everyone greater service by concentrating
on documentation for a while rather than just coding.  Please, at least
catch the documentation up with the current state of things and include
an editable master form in the distribution.

That way the rest of us can help you improve the documentation as well
as the code.
		<a href="http://www.tuxedo.org/~esr">Eric S. Raymond</a>

The people cannot delegate to government the power to do anything
which would be unlawful for them to do themselves.
	-- John Locke, "A Treatise Concerning Civil Government"