IoTeacher commented 7 months ago

Aviso para Estudiantes: Uso de Markdown en Repositorios de GitHub Classroom

Estimados estudiantes,

En el marco de nuestras actividades académicas en GitHub Classroom, queremos destacar la importancia del uso de Markdown para la documentación y presentación de sus proyectos de forma clara y eficaz. Markdown es un lenguaje de marcado ligero que facilita la conversión de texto plano en HTML, lo que permite crear documentos estructurados y fáciles de leer directamente en GitHub.

¿Por qué utilizar Markdown?

Claridad y Estructura: Permite organizar la información de manera lógica, utilizando encabezados, listas, enlaces e imágenes, lo que facilita su comprensión.
Sencillez de Uso: Su facilidad de aprendizaje y uso permite que se concentren en el contenido de su documentación, sin preocuparse por la complejidad del formato.
Compatibilidad: Los documentos creados con Markdown son compatibles con diversas plataformas y herramientas, asegurando que su trabajo sea accesible en diferentes contextos.
Profesionalismo: Un manejo adecuado de Markdown refleja profesionalidad y atención al detalle, habilidades muy valoradas en el ámbito tecnológico.

Directrices para el uso de Markdown en sus proyectos:

README.md: Es indispensable incluir un archivo README.md en la raíz de cada repositorio, donde describan el propósito del proyecto, características, instrucciones de instalación, dependencias y cualquier otra información pertinente.
Documentación del Código: Utilicen Markdown para documentar su código, especialmente en scripts complejos, funciones y módulos, para explicar su lógica y uso.
Informes y Reflexiones: Empleen Markdown para estructurar informes o reflexiones, utilizando títulos, subtítulos, listas y citas para mejorar la legibilidad y comprensión.
Inclusión de Elementos Multimedia: Aprovechen las capacidades de Markdown para incluir imágenes, gifs y enlaces a videos que complementen sus explicaciones o demostraciones.

Recursos para aprender y mejorar su uso de Markdown:

Los animamos a familiarizarse con Markdown y a utilizarlo de manera efectiva en sus proyectos. El dominio de esta herramienta no solo mejorará la calidad de sus entregas, sino que también les proporcionará una habilidad valiosa para su futuro profesional.

Atentamente,

Rene Solis Depto. Sistemas y Computacion

IoTeacher commented 7 months ago

Link GH Classroom: https://classroom.github.com/a/rpPlA_3E 👈 2 PM

Práctica: Uso de ASCIINEMA.org en la Terminal del Servidor de remoto para las actividades generales de esta induccion.

ENLACES: https://asciinema.org/ https://interorganic.com.ar/josx/asciinema.pdf https://picodotdev.github.io/blog-bitix/2015/09/grabar-y-compartir-video-de-la-terminal-con-asciinema/

Objetivos

Familiarizarse con la terminal de AWS, conectarse a una sesion remota e interactuar con el OS.
Aprender a grabar sesiones de terminal con ASCIINEMA.
Desarrollar y demostrar habilidades genericas multi-nivel programación en la terminal.
Documentar y explicar el código y procesos de programación y gestion del servidor.

Practicas

Configura tu entorno de servidor en AWS y prepáralo para la grabación.
Utiliza ASCIINEMA para grabar una sesión de terminal ejecutando tu script de programación. Asegúrate de incluir comentarios explicativos en tu código.
Edita tu grabación para incluir tu nombre y datos generales al inicio o final de la sesión.
Sube el enlace de tu grabación de ASCIINEMA a este repositorio de GitHub Classroom.

Rúbrica de Evaluación

Dominio Técnico (40 Puntos)

Uso de la terminal y comandos básicos: 10 Puntos
Complejidad o repaso del script de programación o secuencia solicitada en clase: 20 Puntos
Claridad en los comentarios del código, de la demostracion que esta ejerciendo: 10 Puntos

Calidad de la Grabación (30 Puntos)

Claridad y fluidez de la sesión: 15 Puntos
Personalización y creatividad el muestreo de plantilla: 15 Puntos

Documentación y Explicación en MARKDOWN (30 Puntos)

Descripción del proyecto en GitHub con sus etiquetado Markdown: 10 Puntos
Explicación de la actividad e incrustrando la grabación en Markdown: 10 Puntos
Reflexión y conclusiones Markdown: 10 Puntos
Utilizar forzosamente el formato de "Código" donde se requierea llevar, recuerde triple comilla par el formato.

Entrega

Sube el enlace de tu grabación de ASCIINEMA a este repositorio antes de la fecha límite. Asegúrate de seguir todas las instrucciones y criterios de evaluación.

Video de aporte

https://www.loom.com/share/0ed229c970d7433f8d222ff305f36526?sid=92aafb1f-1134-4ce7-aa29-4f8242034014

¡Buena suerte!

IoTeacher commented 7 months ago

ACCESO AL RECURSO DE COMPILACION REMOTA

Tutorial: https://www.cyberciti.biz/howto/quick-tip-display-banner-message-before-openssh-authentication/

IoTeacher commented 7 months ago

Rúbrica de Evaluación Completa

Dominio Técnico (40 Puntos)

Criterio	Excelente (8-10)	Bueno (5-7)	Aceptable (3-4)	Insuficiente (0-2)	Puntos
Uso de la terminal y comandos básicos	Uso avanzado y eficiente de la terminal y comandos.	Uso correcto de la mayoría de comandos necesarios.	Uso básico y ocasional de comandos.	Dificultades significativas en el uso de la terminal.	/10
Complejidad del script de programación	Script excepcionalmente complejo y bien estructurado.	Buena complejidad y estructura adecuada.	El script cumple con los requisitos mínimos de complejidad.	El script es demasiado simple o está incompleto.	/20
Claridad en los comentarios del código	Comentarios claros, detallados y útiles en todo el código.	Comentarios adecuados que explican la mayoría del código.	Algunos comentarios útiles, pero faltan en áreas clave.	Escasos o ningún comentario relevante.	/10

Calidad de la Grabación (30 Puntos)

Criterio	Excelente (13-15)	Bueno (9-12)	Aceptable (6-8)	Insuficiente (0-5)	Puntos
Claridad y fluidez de la sesión	Exposición excepcionalmente clara y fluida, sin errores.	Buena claridad y fluidez, con mínimos errores.	Comunicación aceptable pero con varias pausas o errores.	Difícil de seguir, con múltiples errores o pausas.	/15
Personalización y creatividad en el muestreo	Muestra altamente personalizada y creativa, destacando en originalidad.	Buena personalización y algunos elementos creativos.	Esfuerzo mínimo en personalización y creatividad.	Falta de personalización y creatividad.	/15

Documentación y Explicación en MARKDOWN (30 Puntos)

Criterio	Excelente (8-10)	Bueno (5-7)	Aceptable (3-4)	Insuficiente (0-2)	Puntos
Descripción del proyecto en GitHub	Descripción exhaustiva, bien organizada y con etiquetas Markdown adecuadas.	Descripción clara con algunos usos de etiquetas Markdown.	Descripción básica con uso limitado de Markdown.	Descripción insuficiente o inexistente sin uso de Markdown.	/10
Explicación de la actividad en Markdown	Explicación detallada con incrustación efectiva de grabación.	Explicación adecuada con incrustación de grabación.	Explicación básica y/o incrustación de grabación con problemas.	Falta explicación clara o incrustación de grabación.	/10
Reflexión y conclusiones en Markdown	Reflexión profunda y conclusiones bien articuladas.	Reflexión adecuada con algunas conclusiones útiles.	Reflexión superficial con pocas conclusiones.	Reflexión y conclusiones insuficientes o ausentes.	/10

Nota: Utilizar forzosamente el formato de "Código" (triple comilla) donde se requiera llevar a cabo, para asegurar la correcta visualización del formato.

IoTeacher commented 7 months ago