No tienes acceso a esta clase

隆Contin煤a aprendiendo! 脷nete y comienza a potenciar tu carrera

Aprende todo un fin de semana sin pagar una suscripci贸n 馃敟

Aprende todo un fin de semana sin pagar una suscripci贸n 馃敟

Reg铆strate

Comienza en:

3D
13H
52M
26S
Curso de Introducci贸n a Java SE

Curso de Introducci贸n a Java SE

Anah铆 Salgado D铆az de la Vega

Anah铆 Salgado D铆az de la Vega

Java Docs

28/39
Recursos

Los Java Docs son una herramienta usada por muchas otras herramientas y aplicaciones porque nos ayuda a documentar todo nuestro c贸digo usando comentarios. Adem谩s, nos permite visualizar la documentaci贸n en formato HTML.

// Comentarios de una sola l铆nea 
 
/* Comentario 
* en m煤ltiples 
* l铆neas */ 
 
/** 
* Comentario para Java Docs 
* */ 

Aportes 79

Preguntas 1

Ordenar por:

驴Quieres ver m谩s aportes, preguntas y respuestas de la comunidad?

o inicia sesi贸n.

Me sorprende lo cool que es Java. Siempre hab铆a pensado lo contrario de este lenguaje.

Si llegaste hasta este video debo de darte un consejo muy importante:

Si hay una sola cosa a la que le vas a dedicar 100% de tu atencion que sea a esto, por favor, jamas dejes de comentar tu codigo, no solo puedes ahorrarle un dolor horrible de cabeza a tus colegas sino a ti mismo, tu yo del futuro te lo agradecera 馃槂

Documentaci贸n de uso de Javadoc
El siguiente sitio describe la herramienta javadoc e incluye ejemplos de uso y etiquetas v谩lidas para Windows.

Es bastante practico aunque algo tedioso para un junior buscar la documentaci贸n javadoc pero cuando te acostumbras esta bueno porque ya buscas directamente lo que deseas.

Saludos.

Definitivamente esta era una de las cosas de las que no ten铆a conocimiento. Espero poder aprender m谩s de Java y as铆 lograr certificarme y especializarme en este lenguaje.

馃 Documentar el c贸digo es esencial para el mantenimiento y trabajo en equipo

Importante para tener en cuenta ya que la gran mayor铆a de desarrolladores no utiliza el javadoc

Eso mismo me paso con Cobol y es un lenguaje genial. La verdad es que estos lenguajes una vez que los aprendes son fant谩sticos. Vale que son complicaditos, pero merecen la pena.

Javadoc es una utilidad de Oracle para la generaci贸n de documentaci贸n de APIs en formato HTML a partir de c贸digo fuente Java. Javadoc es el est谩ndar de la industria para documentar clases de Java. La mayor铆a de los IDEs los generan autom谩ticament

JAJAJAJA Ame cuando dijo de sacar los frankstein de Stackoverflow xd.

No les pasa que en la u o en el colegio les explicaron todo como a las patadas y los traumaron con java, y llegaron por x raz贸n a este curso y todo es hermoso

Javadoc es una utilidad de Oracle para la generaci贸n de documentaci贸n de APIs en formato HTML a partir de c贸digo fuente Java. Javadoc es el est谩ndar de la industria para documentar clases de Java. La mayor铆a de los IDEs los generan autom谩ticamente

Hola chicos, usen chatGPT cuando no se acuerden de la sintaxis o quieran saber para que funciona una clase, les ahorrar谩 tiempo.

Aunque por otra parte tambi茅n es bueno saber como buscar en la documentaci贸n oficial que hace tal cosa.

Me daba mucha pereza Java pero estos cursos est谩n geniales y le he cogido cari帽o. Gracias.

Javadoc es una utilidad de Oracle para la generaci贸n de documentaci贸n de APIs en formato HTML a partir de c贸digo fuente Java. Javadoc es el est谩ndar de la industria para documentar clases y m茅todos de Java. La mayor铆a de los IDEs los generan autom谩ticamente.

Uso

  • Los comentarios de JAVADOC se generan desde el c贸digo fuente y, por lo tanto, hay que incluir en el mismo etiquetas especiales para poder interpretarlas en la generaci贸n. La etiqueta que determina un comentario JAVADOC es /**鈥*/
  • Un comentario JAVADOC est谩 compuesto de una definici贸n seguida de un bloque de etiquetas relacionadas
/** 
* Comentario para generar Java Docs 
* */
/**
* Frase corta descriptiva
* Descripci贸n de la clase
* @author Nombre Apellido / Empresa
* @version 0.1, 2004/05/30
*/

fuente:

  • Los Java Docs son una herramienta usada por michas otras herramientas y aplicaciones porque nos ayuda a documentar todo nuestro c贸digo usando comentarios. Adem谩s nos permite visualizar la documentaci贸n en formato HTML.
  • Nos ayuda a comprender qu茅 hace el c贸digo.
  • Genera documentaci贸n HTML.
  • Con tan solo utilizando comentarios yo puedo declarar mi java doc.
  • //Comentario en una l铆nea.

Java Doc:
-Nos ayuda a comprender que hace el c贸digo
-Genera Documentaci贸n HTML

No hab铆a escuchado acerca de javadoc y la verdad me parece genial;
Cuando recib铆 clases de java en el SENA, el profesor nunca se esmero por dar clases con conceptos claros nos imparti贸 usando netbeans y fue una p茅sima experiencia, gracias a estas clases me esta gustando mucho java.

/**
me entusiasma aprender java
*/

excelente

Demasiado importante, ya que un codigo puede ser muy extenso, y luego se nos puede olvidar, que hace que

Excelente aporte jamas dejemos de comentar nuestro codigo.

JAVADOC herramienta muy utilizada que nos permite comprender que hace el codigo, ayuda a ilustrar y a entender mas a fondo lo que esta escrito, el resultado del Javadoc es la documentacion en HTML para entrega del proyecto o para compartirlo con el equipo de desarrollo

Es el primer lenguaje de programaci贸n que estudio y me parece super cool.

JavaDoc nos ayuda a identificar en que estamos haciendo para que las personas que trabajan con nosotros tambi茅n puedan ver todo y no estar perdidos, es muy 煤til. //

muy bueno las clases

Me gusta mucho la documentaci贸n

DATO: Este tipo de documentacion en HTML es importarte para compartirla con tu equipo de trabajo y si llega un programador nuevo

<public class Funciones {

    /*
    * Linea 1
    * Linea 2
    *
    * */

    /**
     * 
     * */
    public static void main(String[] args) {
        double y = 3;
        //Area de un circulo
        //pi * r2

        circleArea(y);
        System.out.println(circleArea(y));

        //Area de una esfera
        //4*PI*r2
        sphereArea(y);
        System.out.println(sphereArea(y));

        //Volumen de una esfera
        //(4/3)*pi * r3
        sphereVolumen(y);
        System.out.println(sphereVolumen(y));

        System.out.println("Pesos a dolares: " + convertToDolar(1000, "COP"));
    }

    public static double circleArea(double r){
        return Math.PI * Math.pow(r,2);
    }

    public static double sphereArea(double r){
        return 4 * Math.PI * Math.pow(r,2);
    }

    public static double sphereVolumen(double r){
        return (4/3) * Math.PI * Math.pow(r,3);
    }

    public static double convertToDolar(double quantity, String currency){
        switch (currency){
            case "MXN":
                quantity = quantity * 0.049;
                break;
            case "COP":
                quantity = quantity * 0.00023;
                break;
        }

        return quantity;
    }
}
> 

Amo como Java en VSC asiste en todo

public class Functions_Statements {
  public static void main(String[] args) {

    int radio = 4;
    System.out.println("The area of a circle with a radius of " 
      + radio + " is " + Area_de_un_circulo(radio)
    );

    System.out.println("The are of sphere with radio of " 
      + radio + " is " + Area_de_una_esfera(radio)
    );

    System.out.println("The are of sphere with radio of " 
      + radio + " is " + Area_de_una_esfera(radio)
    );

    System.out.println("cilinder with radio of " 
      + radio + " and height of " + radio 
      + " is " + Volumen_de_un_cilindro(100, 19)
    );

    System.out.println("MXN to USD "
      +convert_To_Dollar(1000, "MXN")
    );
  }

  public static double Area_de_un_circulo(double radio) {
    return Math.PI * Math.pow(radio, 2);
  }


  public static double Area_de_una_esfera(double radio) {
    return 4 * Math.PI * Math.pow(radio, 2);
  }


  public static double Volumen_de_una_esfera(double radio) {
    return (4/3) * Math.PI * Math.pow(radio, 3);
  }


  public static double Volumen_de_un_cilindro(double radio, double altura) {
    return Math.PI * Math.pow(radio, 2) * altura;
  }


  public static double convert_To_Dollar(double quantity, String currency) {
    switch (currency) {
      case "MXN" -> quantity = (quantity * 0.057);
      case "COP" -> quantity = (quantity * 0.00031);
    }
    return quantity;
  }
}```

Confirmo, me gusta JAVA;

Hasta aqu铆 JAVA es verdaderamente bueno y c贸modo para programar. A seguir !!!

Usando los comentarios se puede declarar en el JavaDocs. Se utiliza: /** */

Muy buena clase. Gracias.

Los Java Docs son una herramienta usada por muchas otras herramientas y aplicaciones porque nos ayuda a documentar todo nuestro c贸digo usando comentarios. Adem谩s, nos permite visualizar la documentaci贸n en formato HTML.

Que tuanis eso de comentar/documentar en Javadoc.

Muy interesante la clase, a pesar que para algunas personas es algo tedioso documentar, es muy importante la documentaci贸n de c贸digo.

Estas son las clases que de verdad son un tesoro馃巵

Esta cool comentar con Javadoc.

Gracias JavaDoc

no sabia que java tenia esta facilidad para hacer documentaci贸n de c贸digo fuente ,simplemente interesante

No sabia que Java tenia esto

Siempre hab铆a escuchado este t茅rmino, sin embargo, nunca le prest茅 atenci贸n o no recib铆 la ense帽anza adecuada. La clase es muy clara a contunuar.

Genial!! No ten铆a idea de esto!

Muy interesante.

/**

  • Comentario para Java Docs
  • */

wow no sabia tampoco de esta herramienta

muy chevere la documentaci贸n de java, ahorra mucho tiempo en consultas a internet

Llevaba tiempo pregunt谩ndome como hacer una documentaci贸n de c贸digo, hoy me has sacado de la duda!

Sumanente completo este lenguaje.

Por favor siempre documentar, como programadores no lo hacemos mucho , pero como ayuda

Genial.

Buen aporte, explica muy bien. Apenas estoy empezando y realmente he entendido sin ning煤n problema

Mostr茅 esto en la universidad y mi profresor no sab铆a que exist铆a

La verdad que en el video pasado descubr铆 lo bonito de Java, y reci茅n vamos comenzando 馃槂

Estupenda clase, conoc铆a los dos primeros tipos de comentarios, pero el tercero no sab铆a que exist铆a y la importancia que tiene para documentar las distintas partes de nuestro c贸digo.

Como es la forma de introducir datos desde el teclado al momento de correr el programa? Eso se puede? Como un input

馃槂

No conoc铆a esto.

Necesarias 馃槂

Muy importante para facilitar la comprension del script.

me parece muy interesante, me permite buscar informaci贸n en un solo sitio

public class JavaDoc {
	public static void main(String[] args) {
		
		String name="Platzi!";
		System.out.println("Hola "+name);
		
		/*
		 * Result:
		 * Hola Platzi!
		 */
	}

}

Siempre he querido saber como se genera la documentaci贸n con JavaDocs (si pon铆a los comentarios pero jam谩s lo he visto generado) espero en la otra clase lo digan

Vamos platzi

esto no lo concoc铆a, excelente

Muy claro. Gracias

Toda mi vida me re煤se a aprender java y ahora me encanta.

Que f谩cil se entiende algo cuando la persona que lo ense帽a esta completamente dedicada a ello.

Desconoc铆a esto de Java, me parece genial!

La verdad estoy sorprendido, cuando tom茅 el curso lo hac铆a mas porque es muy demandado en la industria, pero de verdad que se hace muy agradable

incre铆ble

Siempre le he tenido miedo al Backend, de momento, no hay diferencia en cuanto a como se maneja la programaci贸n y la manera de escribir c贸digo. vmaos avanzando


Me encanto javadoc; excelete para buenas practicas 馃槉 馃捇

Documentaci贸n.

 /**
     *
     *
     */