Javadocs - это HTML, поэтому вы можете просто вставлять туда изображения:
/**
* This class does some funky stuff (see diagram).
* <img src="relative/path/to/your/image.png" />
*
*/
public class FunkyClass{
}
Eclipse с радостью покажет вам изображения в представлении Javadoc или при наведении курсора на комментарий. Другие IDE могут или не могут делать то же самое.
Очевидно, что вы должны как-то убедиться, что образы развернуты с помощью javadocs ...