Thread:Manual talk:Coding conventions/Documentation, even if this is MediaWiki/reply (7)

I like almost all of your proposals, just a bit skeptical with the @since. I have noticed, you have been using this in your extensions but even if you tag something as  and in 0.2 the whole function changes and gets new arguments, I am not sure you would update it to   or add a note. One way would be using multiple @since in this case and adding a note behind that how it was different back then. Anyway, I have missed this many times in MW core, would be so much easier to keep backwards compatibility if this were documented properly! Especially for public functions but also for important constants and globals.