Javadoc link to src/main/resource or src/test/resource file using relative path

No need to mention the absolute path. See my package and class structure below. From a sister package if I follow the URI rules I do a .. to go one folder back and mention it like this. It works! On clicking the url the file opens. Although I have illustrated this in eclipse, I think this should be IDE agnostic.

/**
 * Removes all the stop words like a, for, the etc. from the text. For a
 * full list of stop words check
 * <a href="file:../resources/stopWords.txt">/resources/stopWords.txt</a>
 * 
 * @return String free of all the stop-words
 * @param text
 *            The string to be cleaned, do null check at your end
 */

This makes a clickable link in IntelliJ IDEA, but only to a directory :-/.

src/test/resources/some/path/

/**
 * {@link some.path}
 */

It doesn't work if you add a filename.ext, nor if a directory is an illegal package name (e.g.: starts with a number).

So far this is best I found. Not great, but still handy to hint static files usage (like external API responses) and provide a link to their location, in tests I found.

Not quite an answer but a feature of IDE:

If you use Intellij IDEA, it is possible out-of-the-box. Where you load the file you must specify the path, right? So you Ctrl+click on a path and Intellij just brings you to the file.

The path is relative to the classpath so you have portability.

It requires all the team members to use Intellij, yes, not a global solution, not a "literal" solution.

Check this: