I'm a big fan of `@since` to document the uPortal version in which a class became available so that it's easier to understand what version dependencies are being entailed by code that makes use of APIs, but I recognize this is not a universal practice.  Still, I recommend.