Avatar ·

¿Cómo referenciar correctamente métodos en Javadoc y qué es {@link}?

¡Hola a todos! Acabo de empezar a aprender Java y estoy escribiendo documentación para mi proyecto. Me encontré con un problema: quiero hacer referencia a otro método en los comentarios Javadoc para que la documentación sea más fácil de leer. Por ejemplo, tengo una clase `Calculator` con los métodos `add()` y `sumAndPrint()`. En el segundo método, quiero indicar en la descripción que llama a `add()`. Intenté escribir simplemente `#add` o `{@link add}`, pero no funciona: el enlace no aparece en la documentación HTML generada. En la documentación oficial dice algo sobre `{@link #methodName}`, pero no entiendo cómo especificar la ruta completa si el método está en otra clase o tiene parámetros. Aquí hay un ejemplo de mi código: ```java /** * Calculadora para operaciones aritméticas simples. */ public class Calculator { /** * Suma dos números. * @param a primer número * @param b segundo número * @return suma de a y b */ public int add(int a, int b) { return a + b; } ```