[Twisted-Python] "Stability: Unstable" might be clearer as "API status: unsupported"?
Andrew Bennetts
andrew-twisted at puzzling.org
Sun Sep 24 19:39:03 MDT 2006
glyph at divmod.com wrote:
> On Sun, 24 Sep 2006 10:54:15 -0400, Itamar Shtull-Trauring
[...]
>
> >So as long we are up front and visible about existing limitations in
> >these reactors, our users benefit by us including them.
>
> I don't think we have nearly enough visibility on the quality or stability
> of those reactors. "Stability: Unstable" means "we might change this", not
> "it is known to be broken and to fail numerous tests".
As a tangent, people seem to get confused by this. Perhaps it would be less
ambiguous to replace "Stability: Unstable" with something like:
API status: in flux
or:
API status: unsupported
and "Stability: stable" with:
API status: supported
Just to remove the ambiguity?
-Andrew.
More information about the Twisted-Python
mailing list