[xwiki-devs] [Brainstorming] How to define @since when the package changes?

Hi devs, I always ask myself this question so I think we need a common agreement. So here’s the question: * I have added some code in version N and this I have a "@since N” in the code * In version M (M > N), I move the class/interface to a new package Question: Do I change the @since annotation to “@since M” or not? 2 possibilities: * Reasoning 1: it’s a new class/interface since the FQN of the class/interface has changed and thus we should use “@since M” * Reasoning 2: even though the FQN has changed it’s still the same code that was moved and from a user POV, it was still introduced in version N and thus we should keep “@since N" WDYT? I’m hesitating. The most technically correct answer is Reasoning 1 IMO but the most useful one is probably Reasoning 2 since the question we wish to answer is probably: “when was this code first introduced?”. Thus reasoning 2 seems slightly better to me. Thanks -Vincent