old_README.md

Parte 2 para la práctica 1 del curso de Optimización 2 2021-1: implementación de método numérico para resolver problemas de optimización convexa.

Antes de iniciar a trabajar:

• Sólo una persona de cada equipo debe darle click a la liga que está indicada en la publicación del google classroom. Una vez que le dé click a la liga tal persona invite a sus integrantes de su equipo como Admin. Para invitar a su integrante ir dentro del repo a Settings -> Manage Access y enviar la invitación ingresando user de github de su integrante.

• Su primer commit debe ser para renombrar este archivo README.md por old_README.md para que guarden su contenido y crear otro README.md donde me escriban la división de su equipo en una tabla que contenga en una columna user de github y en otra columna la tarea a realizar por tal persona (más detalles sobre las tareas en dinámica).

Instrucciones

Se encuentran en el archivo instrucciones.ipynb.

Dinámica

Dividir a su equipo para realizar tres tareas. Ustedes deciden qué integrante resuelve qué tarea:

1. 2 personas que programen el método numérico elegido y elijan los ejemplos para los tests.

2. 1 persona que apoye en la construcción de los github workflows (build & push y tests) y documentación del paquete.

3. 1 persona que sea project manager (más detalles de este rol en las notas). Que apoye en la búsqueda de ejemplos y/o documentación para las tareas anteriores. Que cree el botón de binder. Que publique la documentación del paquete online

Entre todos los y las integrantes tienen que dar feedback si es necesario en la resolución de las tareas que haya duda entre ustedes. El feedback consiste en resolver/explicar las dudas que existan. Las personas asignadas a la tarea correspondiente son las que realizan los commits una vez resueltas las dudas.

Los puntos 1, 2 y 3 anteriores los realizan de forma iterativa hasta finalizar las tareas y que estén en acuerdo las y los integrantes de cada equipo con las soluciones.

Deben usar git para llevar la historia de cambios en la realización de sus notebooks o cualquier otro archivo y subirlos a sus repos. No se revisarán aquellos archivos que tengan un commit con todas las respuestas. El trabajo es incremental.

Deben usar la funcionalidad de github: issues, milestones, projects, reviewers, asignees o lo que ustedes consideren de github que les ayudará a comunicarse/organizarse (no tienen que usar todas las funcionalidades anteriores y cada equipo decide qué usar). Ver por ejemplo video para crear proyectos en github.

Lenguajes de programación

Ustedes eligen el lenguaje de programación a usar.

Calificación

La calificación de esta segunda parte es la mitad de la práctica 1. Se asgina una calificación individual por tarea asignada y una calificación por equipo. Se calificará de acuerdo a los commits realizados y a los avances que realizan en su trabajo incremental.

AWS

Adjunten screenshots en un directorio de su repo para mostrar su uso de AWS, debe aparecer en el screenshot su nombre, clave única u otra forma de identificar su trabajo. El trabajo en la nube consiste en probar las ejecuciones de su paquete.

Usen las cuentas de Educate si no usan GPUs, si quieren usar GPUs envíenme un mensaje por gitter para usar la cuenta no de Educate.

Todas las personas del equipo conocen cómo levantar, configurar instancias de AWS y desplegar servicios allí. Uds elijan a una persona que sea la encargada de realizar lo anterior.

Notas

• Para la entrega crear un archivo con nombre: reporte_equipo_<aquí colocar_número>_parte_2_practica_1.ipynb y contiene ejecución del paquete para los ejemplos elegidos.

• Project manager: es la persona más importante para el éxito del proyecto. Conoce el/los objetivo(s) a resolver, detalla las tareas que realizarán el grupo de programación y el grupo de revisión (creación de tests en nuestro caso), organiza y asigna a personas a ambos grupos, crea tarjetas en el project board de github y milestones para dar seguimiento a issues. Mantiene un contacto directo con el prof para dudas que tengan y para avisar en qué fase se encuentran. Les explica a su equipo de trabajo la correcta creación de issues, solución de los mismos y el uso de milestones y del project board.

• La división de las tareas y roles está está inspirada en el framework scrum en un ambiente laboral real (y en esta práctica estamos super-simplificando tal framework).

• Añadan referencias utilizadas para su trabajo en su README.md.

• Los commits deben tener un mensaje explicatorio, no hacer lo siguiente:

git commit -m "create 1" -i archivo1.txt

git commit -m "update 1" -i archivo1.txt #qué es update 1?

git commit -m "update 2" -i archivo1.txt #qué es update 2?

git commit -m "update 3" -i archivo1.txt #qué es update 3?

así también para los issues, projects, milestones...

• Esta organización es nuestro playground utilicen los repos de aquí para practicar :)

• Recuerden:

  • usar git para llevar la historia de sus cambios en sus repos :)
  • poner las referencias que utilizan (aún si le preguntan a una compañera o compañero de la clase coloquen esto en su entrega) pues no está permitido copiar y escribir que lo hicieron sin citar sus fuentes.

• Para dudas creen un room de gitter e ínvitenme :) (si ya lo hicieron omitan este enunciado)

• Su trabajo individual y su tiempo es muy valioso e importante, también el trabajo en equipo. Si alguna persona del equipo no realizó su tarea asignada, esperaría que lo resolvieran entre ustedes, si no lo resuelven avísenme y no realicen su tarea asignada. Si tienen algún problema (familiar, salud,...) infórmenme con tiempo para ver qué podemos hacer :)