Reportes de prácticas

Las actividades del laboratorio y los reportes se pueden llevar a cabo de manera individual o en parejas.
Los reportes de las prácticas deben ser elaboradas en español usando el formato de documentos AsciiDoctor. Para instalar AsciiDoctor en Ubuntu, teclear desde la terminal:
```
sudo apt-get update
```
```
sudo apt-get install ruby-dev
```
```
sudo gem install asciidoctor pygments.rb
```
```
sudo gem install --pre asciidoctor-pdf
```
NOTA: Si el sistema reporta que no encuentra el comando gem, será necesario instalar Ruby primero.

Se debe utilizar el siguiente comando en la terminal para generar el reporte en formato PDF, reemplazando archivo.txt por el nombre correcto:
```
asciidoctor-pdf archivo.txt
```
Ligas útiles de AsciiDoctor:

Estas son las secciones que debe contener todo reporte:

Sección	Descripción
Encabezado	Debe incluir el título de la práctica, así como las matrículas, nombres y correos electrónicos de los autores del reporte.
Introducción	Establece el propósito y la estructura del contenido del reporte. Debe tener una extension de al menos 100 palabras.
Desarrollo	Explica a detalle el problema y la manera en que se procedió a resolverlo. Esto se debe hacer de manera auto-contenida. Esto significa que se debe suponer que el público que leerá el reporte ha llevado este mismo curso, pero en alguna otra universidad, y por tanto no ha leído los mismos libros, ni tampoco la descripción de la práctica del laboratorio. También se debe incluir en esta sección todo el código fuente que se haya escrito para resolver el problema.
Pruebas	Debe incluir las imágenes de las pantallas con la salida producida por el programa. Los autores son responsables de probar todas las funciones, clases o métodos de manera completa y convencer al lector de que todo el código funciona correctamente. Si el código contiene un bug, se debe documentarlo en el reporte, explicando todo lo que se sabe sobre él. Si no se reporta un bug se asume que: (a) las pruebas fueron inadecuadas y/o insuficientes o (b) se fue deshonesto en el reporte. De cualquier forma, la calificación será reducida de manera más severa que si simplemente se hubiera reportado el bug.
Conclusión	Resume lo que los autores aprendieron durante el proceso de elaboración de la práctica. Debe tener una extension de al menos 100 palabras.
Agradecimientos	(Opcional) Incluir aquí el nombre de cualquier persona que les haya ayudado a desarrollar la práctica de laboratorio.
Referencias	Cualquier documento consultado (electrónico o en papel) debe ser incluido en esta sección.

Es importante que también se consideren los siguientes puntos al momento de elaborar los reportes:
- Utiliza siempre oraciones completas, con buena redacción y ortografía.
- No coloques en el reporte las instrucciones ni los códigos que vienen en la descripción de la práctica de laboratorio. La única excepción permitida son porciones reducidas de código que ayuden a entender mejor el contexto del código que tú escribiste.
Respecto al código fuente de JavaScript desarrollado:
- Dentro de lo posible se debe aplicar la guía de estilo de Node.js.
- Se debe indentar el código usando dos espacios por cada nivel lógico. No se deben utilizar caracteres de tabulador (código ASCII 9), también conocidos como hard tabs. En su lugar, asegúrate que tu editor reemplace los tabs por espacios.
- Todos los programas deben funcionar en modo estricto de ECMAScript 5. Por lo tanto, la primera instrucción de cada archivo fuente (sin contar espacios en blanco o comentarios) debe ser siempre:
```
'use strict';
```
- Nunca se deben utilizar los operadores == ni !=. En su lugar usar siempre === y !==.
Ejemplos de documentos:
- Reporte en AsciiDoctor: practica0.tgz
- PDF generado: reporte_practica0.pdf

Este documento está parcialmente basado en: Suggestions for clear lab reports in computer science courses.

Desarrollo de aplicaciones web

Reportes de prácticas