I think @since annotations are probably useless.
I disagree, and know that quite some other extension developers do to. Have
you actually been in the situation where you are writing an extension that
needs to be compatible up to a certain previous MediaWiki release, and where
forced to go look where every method, class and hook was added on ViewVC? I
have, and can tell you it's not fun or productive. Of course, if you do only
core developement and are familiar with most of the code and it's history,
then yes, it's not terribly useful for you personally.
--
Jeroen De Dauw
*
http://blog.bn2vs.com
*
http://wiki.bn2vs.com
Don't panic. Don't be evil. 50 72 6F 67 72 61 6D 6D 69 6E 67 20 34 20 6C 69
66 65!
--
On 15 August 2010 19:36, Aryeh Gregor
<Simetrical+wikilist@gmail.com<Simetrical%2Bwikilist@gmail.com>
wrote:
> On Sun, Aug 15, 2010 at 7:27 AM, Niklas Laxström
> <niklas.laxstrom(a)gmail.com
wrote:
> > The
issue of how to use @since annotations recently came up in the
> > code review. Those are essential for extension developers who want to
> > target multiple MediaWiki versions with one codebase. I think we
> > should come up a standard way to use those.
>
> I think @since annotations are probably useless. You can't reliably
> tell if an extension will work on an old version without actually
> testing it on the old version, and if you do that, you can figure out
> what works by the error messages. Just because a method or class was
> present doesn't mean it worked the same way, so @since is not enough.
> It's got to be less work to just try it than to check every single one
> of the dozens or hundreds of methods you use for compatibility, too
> (which no one is going to do).
>
> If you do want to find out if a method is in the version you're
> targeting, there's a very easy way: check out the branch in SVN and
> look in the file. Or use ViewVC. It's not really harder than looking
> in the source code. On the other hand, manually adding @since
> clutters the comments, makes that much less code fit on one screen,
> and will create zillions of cleanup commits (which we already have too
> many of).
>
> So I think we shouldn't use @since at all, personally.
>
> _______________________________________________
> Wikitech-l mailing list
> Wikitech-l(a)lists.wikimedia.org
>
https://lists.wikimedia.org/mailman/listinfo/wikitech-l
>