-
Type: Improvement
-
Resolution: Fixed
-
Priority: Unknown
-
Affects Version/s: None
-
Component/s: None
-
Fully Compatible
@since comments are generally not useful:
- The project is now quite mature. @since was perhaps useful when there were radical changes between 1.0, 2.0, and 3.0, but those days are long gone.
- They do not reflect significant interface changes to methods
- They are not accurate, for example they have been kept in-place when code was moved to other classes
- We're not adding them on new PRs
- It adds clutter and makes code harder to read.
Instead of tagging each method with @since we should simply be following Semver, and be mindful when we are change public method behavior.