Just curious, when you add things to the core, do you guys tag it as @since 2.9? I tag it as @since GSOC 2009 but I want some opinion on this. Cheers
Rudolf Lai, DD32, and Beau are discussing. Toggle Comments
If/when something is added to core it should ideally be tagged with @since, yes. You should probably just leave it blank for now though, because even if your code is ready for the next version, a committer might not get to it in time (leading to incorrect information, which is worse than no information).
Have a look at some of the code in the admin, and it’ll be: “@since unknown” Another way would be to replace it with “@since gsoc-2009-unknown-version-REPLACE” or some similar value thats unique, Just to make it easy for a find/replace by the commiter. If you’ve only a few functions, leaving it as unknown is fine.. but if its a lot, and you’re writing the docs, just use a unique string
Hey thanks for the reply guys. I guess the @since tag is not really for me then, since for any code changes Mark ( or for that matter, any committer ) can easily know via the .diff patch. I was documenting the new code today and I thought I should put the @since tag in for the sake of completion.
P.S. I will issue a new patch soon.
← This week I have been mainly sorting out…
Paged comments are proving to be much mo… →
Create a free website or blog at WordPress.com.