1
00:00:10,670 --> 00:00:15,440
Hola te saluda Jubal lacosta bienvenidos nuevamente.

2
00:00:15,440 --> 00:00:18,710
Espero que estén listos para comenzar con esta elección.

3
00:00:18,890 --> 00:00:25,630
Vamos a estudiar a continuación el tema de cómo documentar un programa en Java utilizando Java Doc.

4
00:00:25,820 --> 00:00:26,950
Están listos.

5
00:00:26,990 --> 00:00:27,470
Vamos

6
00:00:30,500 --> 00:00:38,300
Java Doc en Java Java permite documentar nuestras clases por medio de Java Doc el cual es un documento

7
00:00:38,300 --> 00:00:46,150
HTML que muestra la documentación de cada una de las clases de un proyecto en Java podemos observar

8
00:00:46,360 --> 00:00:53,110
que a diferencia de los comentarios normales de Java es decir con doble diagonal o con Diagonal asterisco

9
00:00:53,320 --> 00:01:00,790
para que nuestro comentario sea incluido dentro del documento HTML generado es necesario que los comentarios

10
00:01:00,790 --> 00:01:08,840
tengan la forma de Diagonal doble asterisco y se cierran con asterisco diagonal dentro de esto se agrega

11
00:01:08,930 --> 00:01:17,150
el comentario de Java Doc y de esta manera se puede ir documentando ya sea la clase un atributo un constructor

12
00:01:17,320 --> 00:01:24,160
o un método así que en el código mostrado se muestran varios ejemplos de cómo documentar cada una de

13
00:01:24,160 --> 00:01:26,530
las secciones de nuestra clase.

14
00:01:26,530 --> 00:01:32,320
Podemos observar también que se pueden utilizar algunos elementos para indicar algunas características

15
00:01:32,320 --> 00:01:38,910
más de la documentación como son arroba autor arroba Berjón arroba Robuchon.

16
00:01:39,010 --> 00:01:45,890
Entre algunos elementos más y el resultado de generar el Java Doc de esta clase es como sigue.

17
00:01:45,940 --> 00:01:52,360
Vamos a poder observar que tenemos por ejemplo un nombre de paquete si es que estuviera asignado a alguno.

18
00:01:52,420 --> 00:01:55,010
Posteriormente el nombre de la clase.

19
00:01:55,210 --> 00:02:00,910
También podemos observar que esta clase debido a que no extiende de ninguna otra clase entonces hereda

20
00:02:00,910 --> 00:02:08,170
de manera automática de la clase obvie la cual se encuentra dentro del paquete Java punto Langue y posteriormente

21
00:02:08,170 --> 00:02:15,160
se muestra cada uno de los elementos que hemos documentado desde los atributos métodos o constructores

22
00:02:15,160 --> 00:02:16,590
de la clase.

23
00:02:16,600 --> 00:02:20,590
A continuación vamos a ver algunos elementos más cuando utilizamos Babadook

24
00:02:23,630 --> 00:02:30,200
caracteres de escape al utilizar cadenas en la tabla mostrada podemos observar los elementos que se

25
00:02:30,200 --> 00:02:36,740
pueden utilizar al momento de documentar nuestras clases cada uno de los elementos mostrados tiene una

26
00:02:36,740 --> 00:02:43,010
breve descripción para que tengamos conocimiento de qué significa cada uno de ellos y en el ejercicio

27
00:02:43,010 --> 00:02:48,590
que vamos a realizar a continuación vamos a poner en práctica varios de estos elementos.

28
00:02:48,590 --> 00:02:56,480
Por ejemplo el elemento de Assor significa el nombre del autor del programa arroba Eudes indica que

29
00:02:56,480 --> 00:03:03,880
el elemento es obsoleto pertenece a versiones anteriores y ya no se recomienda su uso arroba paraun

30
00:03:04,240 --> 00:03:11,380
define un parámetro de un método a robar Critón es la descripción de lo que devuelve el método y no

31
00:03:11,380 --> 00:03:17,650
se utiliza en el constructor o en métodos de tipo bait ya que estos métodos o constructores no regresan

32
00:03:17,770 --> 00:03:26,320
ningún tipo arroba si indica que se asocia con otro método u otra clase arroba derechón indica la versión

33
00:03:26,320 --> 00:03:32,740
del método o clase que se está utilizando en el ejercicio que realizaremos a continuación pondremos

34
00:03:32,740 --> 00:03:36,430
en práctica el concepto de Java DOGC utilizando el lenguaje Java.