I’ve noticed that Eclipse automatically adds an @author tag with my name at the top of a new Java class. I also noticed that there are other tags available like @version, @link, @code, @value, @see…
Is it just another ‘convention’ that has formed so that code remains well-documented? Or is there some other purpose?
I tried finding a website that would give better descriptions of the tags and their usage, but I didn’t have any luck.
These are Javadoc tags related to the Javadoc mechanism. When you’ll generate the Javadoc (there’s an option in the Eclipse menu for that), those link will be interpreted appropriately and the Javadoc will be better detailed. See the link in the comment for the list of all available tags.
Underestimate the power of documentation you will not.