Índice de Contenidos

Aprender GitHub Classroom y Markdown

GITHUB EN EL AULA

Un Curso OCW de la ULL

Aprender GitHub Classroom y Markdown

La siguiente sección establece los objetivos y competencias que debes lograr. Las subsiguientes secciones presentan los recursos para lograr estos objetivos.

Objetivos

Objetivo 1: Primeros Pasos con GitHub Classroom

Deberás comenzar aceptando la tarea asociada a esta parte haciendo click en el botón con el texto “acepta la asignación de la tarea” en la cabecera. En cada una de los temas que requieren de la creación de un repositorio de trabajo para la realización de las tareas asociadas al tema encontrarás un botón con el texto en la cabecera de la página. Para aprender a aceptar una tarea sigue los pasos en Como aceptar una tarea de grupo

Un primer objetivo de esta lección/tarea es conseguir cierta familiaridad con los conceptos que conlleva Github Classroom: asignación, asignación individual, asignación de grupo, identificación del alumnado, rosters, etc.

Este video en YouTube “How to use VS Code to submit an assignment to Github Classroom (initially empty repository)”

muestra como deben hacer los estudiantes para aceptar, trabajar y entregar una tarea asignada con GHC usando el editor VS Code

Objetivo 2: Aprender Markdown

Otro objetivo de esta tarea es aprender Markdown. Para ello, en el repositorio que se crea cuando aceptas la asignación deberás rellenar los contenidos del fichero README.md con un pequeño curriculum vitae/carta de presentación usando markdown.

Incluye alguna imagen
Incluye algunos enlaces (por ejemplo un enlace a tu usuario en el campus virtual o el LMS de tu institución educativa).
Incluya al menos una lista enumerada y una lista no ordenada (bullets)
Una cita favorita (blockquote)
Un fragmento de código inline de un lenguaje de programación
Incluye un trozo de código que ocupe varias líneas como este y asegúrate de que aparece coloreado:
```
function fancyAlert(arg) {
  if(arg) {
    $.facebox({div:'#foo'})
  }
}
```

Incluye una tabla. Puede hacerse así:

  First Header | Second Header
  ------------ | -------------
  Content from cell 1 | Content from cell 2
  Content in the first column | Content in the second column

y se verá así:

First Header	Second Header
Content from cell 1	Content from cell 2
Content in the first column	Content in the second column

Incluye un emoji. Por ejemplo :+1: se ve:
Añade un fichero master.md (puedes crearlo usando el menu o bien visitando una ruta con la sintáxis https://github.com/:owner:/:repo:/new/main) en el que describas tu experiencia hasta ahora en este master y lo enlazas desde el fichero README.md.
1. Incluyas alguna imagen en el repo en una carpeta img y la muestres desde el texto
2. Añadas un segundo fichero en el repo con nombre objetivos.md contando cuáles son tus objetivos con respecto a este curso y lo referencies desde el fichero README.md. Añade una referencia/enlace de vuelta en objetivos.md a tu README.md
- En el fichero master.md pon un enlace de vuelta al README.md
Podemos hacer uso del editor que provee la interfaz web de GitHub.
Pero hay editores alternativos mejores como el editor web de GitHub y GitPod
Recuerda hacer “commits” para guardar los cambios.
En la tarea entrega el enlace al repo con los contenidos de tu trabajo
Añade una imagen-enlace. Se deberá ver la imagen pero esta será un enlace a otra página

En este enlace puedes visitar ejemplos de lo que han hecho algunos alumnos de la asignatura Aprendizaje y Enseñanza de la Tecnología del master de Formación de Profesorado en el curso 21/22

Objetivo 3: Aprender a Usar un Editor en la Nube

Hay múltiples formas de editar en la nube un repositorio GitHub. en estas notas recogemos estas alternativas:

Editar directamente usando el editor on-line de GitHub
Usar el editor GitHub.dev. Véase también las notas en estos apuntes sobre GitHub.dev. Véase también las notas en estos apuntes sobre GitHub.dev: se activa simplemente tecleando el punto cuando se está visitando el repo
Usar Codespaces (Probablemente la opción mas recomendable si dispones de este servicio)
Usar GitPod, una alternativa a Codespaces

Objetivo 4: Aprender a Usar GitHub Discussions

Cuando termines esta tarea puedes ir al foro de la organización y saludar. Así practicas un poco mas de markdown.

Publica tu entrada en la categoría Cuéntanos lo que haces (tienes un ejemplo de entrada en https://github.com/orgs/ULL-OCW-GITHUB-EDUCATION/discussions/2).

Si quieres saber mas sobre como añadir un foro de debate a tus repos y como administrar los foros puedes consultar la documentación en GitHub Discussions

Introducción a GitHub Classroom (como estudiante)

Los profesores de este curso han configurado la tarea asociada usando GitHub Classroom (que abreviaremos a veces como GHC). GitHub Classroom es una aplicación web para los docentes que proporciona herramientas para la administración de cursos integradas con GitHub.

En este capítulo tu contacto con GHC es como alumno. Para aprender a usar esta herramienta como profesor es conveniente que

Hagas posteriormente la tarea GHC para Profesores
Sigas el curso Teach with GitHub Classroom.
Puedes encontrar un buen número de vídeos que complementan el curso en la sección Videos about GitHub Classroom

Verás que con GHC permite crear asignaciones individuales y de grupo.

Introduccion al Lenguaje de Marcas MarkDown

Lee

Escribir en GitHub
El tutorial Mastering Markdown para saber mas sobre esta forma de elaborar documentos
Para mas detalles consulta la guía de usuario Getting started with writing and formatting on GitHub

Introducción a la Edición en la Nube de Repositorios GitHub

Para manejar todo el proceso de edición pueden ayudarte estas notas sobre Edición en la Nube.

Si no tienes mucha experiencia y no estás familiarizado con VSCode lo mas sencillo es que en esta tarea uses el editor on-line de GitHub.

Si estás familiarizado con VSCode, basta con pulsar un punto en tu navegador cuando estás visitando tu repo de trabajo para que se active una version reducida de VSCode que es conocida como GitHub.dev Editor. Aún mejor, usa GitPod o CodeSpaces

Rúbrica

Se incluyen todos los aspectos solicitados en el markdown y se visualizan correctamente
Informe elaborado correcto
Ha entregado el enlace en el campus con el repo