[Zope3-dev] Re: Zope 3 as a reliable platform?!?

[Lennart Regebro]

On 9/5/06, Philipp von Weitershausen <philipp at weitershausen.de> wrote:
> Because they'll go away.
>
> Why?
>
> Because it's clutter. And because there should preferrably be only one
> way to do things. If we left all the old ways around indefinitely, we'd
> have code that uses two or more ways of doing the same thing all over
> the place. It would set bad examples, to begin with.
>
> Theuni was recently very confused about the difference between three
> different APIs that do exactly the same thing (registering a utility).
> If we had deprecated at least the most confusing one of them (ztapi)
> already, it would probably have been much clearer.

I agree. And as long as you move from one version to the next, it's
not a problems, since we have BBB-code. It does become a problem when
you skip versions, though. And therefore, we really need to make an
overview over all API changes from 3.0.0 so you can see what happened
(this in addition to the more detailed "whats new in vX" pages.

Maybe somebody can start such a page somewhere, and we can fill it in gradually?