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@gmail.comwrote:
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