Hi Mariya,
Yes, from my perspective, it's the documentation, and not the changes in
the code, that's the bigger issue. Others might have different opinions.
I haven't analyzed the code, but I'm pretty sure the majority of classes
and methods don't have a @since tag. Now, I don't know if it would be a
good use of anyone's time to go back and add @since tags to every public
class and method (though then again, maybe it would be), but it would be
nice for developers to try to make sure to always do it going forward. Some
do it already, which is good.
-Yaron
On Thu, Feb 14, 2013 at 7:26 AM, Maria Miteva <mariya.miteva(a)gmail.com>wrote;wrote:
Hi,
Thank you for the replies. I guess I keep understanding this wrong.. So
for what I understand, the problem is not that much in the frequent changes
in hooks and classes. etc. MediaWiki seems to be doing a good job with
that?
Tha problem seems to be in documnting how things should be done, what each
class does in detail, and since when and until when a class has been and
will be active. Do I understand correctly now?
Are there examples of classes which :
* don't have a good enough description?
* are not marked with @since other than WikiPage? Or is this the majority?
* have been deprecated without warning?
* changed witout warning?
Regards,
Mariya
--
WikiWorks · MediaWiki Consulting ·
http://wikiworks.com/