Envío de talleres: Términos y Condiciones

Acerca del envío de los talleres y su valor académico

Conforme a lo dispuesto en el cronograma de curso, cada taller puede ser enviado con el fin de obtener una calificación suplementaria. El envío de cada taller se encuentra sujeto a las instrucciones proveídas en el enunciado del taller correspondiente. Sin embargo, para que un taller sea evaluado se deben cumplir las siguientes 3 condiciones:

Condición 1 : Organización de su repositorio

En el repositorio Git, que le fue asignado al inicio del curso, deberá existir una carpeta que lleve por nombre taller_n, dónde n corresponde al número del taller que se desea someter a evaluación.

A continuación es posible apreciar un ejemplo de la estructura que debería tener su repositorio para cumplir con la normatividad dispuesta para el envío de talleres.

root
│   README.md
│      ...
│   Más archivos
│
├───taller_1
├───taller_2
├───taller_3
├───  ...
├───taller_n
├───  ...
└───Otras carpetas

Condición 2 : Estructura de un taller

Todo taller deberá tener la estructura que se muestra a continuación. Se recomienda antes de iniciar un taller descargar el archivo esqueleto.zip y renombrar la carpeta taller según corresponda, este archivo contiene la estructura requerida.

El siguiente esquema muestra la estructura que debería tener la carpeta de cada taller.

taller_n
├── README.txt         // Archivo con la información solicitada (depende de cada taller)
├── calificacion.txt   // Archivo que indica que el taller se debe calificar
└── src                // Carpeta donde se almacena el código fuente
    └── taller         // Paquete principal que debe existir en todos los talleres
        ├── Main.java  // Clase principal del taller que ejecuta la app
        ├── ...        // Otros archivos java con el código fuente de la app
        └── test       // Paquete principal donde se deben almacenar todas las pruebas
        │   ├── ...    // Archivos java con el código fuente de las pruebas
├── data               // Carpeta en donde se almacenan los datos de la app
├── dist               // Carpeta en donde se almacena el archivo taller.jar de la app
├── docs               // Carpeta en donde se almacena el javadoc de la app
├── lib                // Carpeta con las librerías de la app
├── project.xml        // Archivo con la configuración del proyecto en DrJava
├── build.xml          // Archivo ant para compilar la app
├── run.sh             // Archivo sh para ejecutar la app (Unix)
├── run.bat            // Archivo bat para ejecutar la app (Windows)

Condiciones esenciales para la evaluación

Es importante verificar las siguientes condiciones para que su taller pueda ser evaluado de forma correcta:

1. La clase principal de cualquier taller deberá ser Main.java y deberá estar en el paquete taller. Usted puede crear otras clases y decidir su organización pero la clase Main.java será utilizada para ejecutar su aplicación y evaluarla.
2. El taller debe tener el archivo project.xml que permita abrirlo en DrJava.
3. Archivo README.txt con la información solicitada en cada taller.

Condición 3 : Archivo calificacion.txt

Para que un taller sea evaluado usted deberá crear un archivo vacío denominado calificacion.txt en la carpeta del taller correspondiente. Por ejemplo, si usted desea que el taller 1 sea calificado deberá existir un archivo calificacion.txt en la carpeta taller_1 de su repositorio. Si la carpeta no contiene este archivo se entiende que usted no desea que el taller sea calificado.

Recomendaciones acerca del desarrollo del proyecto

Es posible desarrollar y editar los archivos que contienen el código fuente Java en diversos editores de texto diseñados específicamente para el desarrollo de código fuente en diversos lenguajes de programación, además de texto plano. Estos programas presentan diversas opciones de edición, tal como sintaxis resaltada, un intérprete en consola del lenguaje actual, así como atajos de teclado. Para el curso se utilizará DrJava un entorno liviano y versátil para el desarrollo de programas en Java, el cual está diseñado y ajustado específicamente a las necesidades presentadas en un entorno de aprendizaje. Otros editores que puede utilizar son gedit, Sublime Text, GNU Emacs o vi.

Sin importar la elección del entorno de desarrollo que sea pertinente y adecuada para cada estudiante, todo proyecto debe cumplir las normas presentadas en este documento.

1: Nota: DrJava actualmente solo soporta la especificación 7 del lenguaje Java.