Presentamos los representadores

¡Ya hemos lanzado por completo la segunda parte de nuestra estrategia de comentarios automatizados: los Representers! En esta publicación te damos un repaso rápido de cómo funcionan y de por qué son tan útiles. Es un poco más técnico de lo normal, ¡así que abróchate el cinturón!

¿Qué es un Representer?

Un Representer es un programa que toma la solución de un estudiante y devuelve una representación normalizada de ella. Después usamos estas representaciones para agilizar los comentarios automatizados y la clasificación.

Un ejemplo es la mejor forma de explicar qué son los Representers. Supongamos que dos estudiantes envían dos entregas al ejercicio hello-world en Ruby:

# Student 1's submission
def self.hello(name = 'World')
  "Hello, #{name}!"
end

# Student 2's submission
def self.hello(nom='World')
    "Hello, #{nom}!"
end

Aunque el código de estas soluciones es distinto (la indentación, los nombres de las variables y la sintaxis de los strings son diferentes), en esencia son lo mismo. Así que, al crear una representación normalizada de ambas, podemos tratarlas como si fueran la misma a la hora de dar comentarios.

¿Por qué es útil?

Al crear estas representaciones normalizadas, nos aseguramos de que los comentarios que se dan sobre una entrega se apliquen automáticamente a otras soluciones similares. Esto significa que, como estudiante, es mucho más probable que recibas comentarios al instante y muy relevantes. Y como mentor, ya no deberías necesitar dar los mismos comentarios dos veces a una solución similar: los das una vez en la interfaz de Automation y el resto funciona como por arte de magia.

También podemos usar los Representers junto con nuestros Analyzers actuales. Los Analyzers pueden comentar aspectos generales (como los nombres de las variables, el linting, etc.) y las representaciones pueden centrarse en los cambios más amplios que conviene hacer. Hay un potencial enorme y no hemos hecho más que arañar la superficie.

¿Quién puede añadir comentarios?

La posibilidad de añadir comentarios a las representaciones está limitada a nuestros supermentores, unas 150 personas que han mentoreado a cientos de estudiantes y han mantenido una valoración alta como mentores.

Si eres supermentor, ahora deberías ver la pestaña «Automation» desbloqueada en tu Mentoring Dashboard, que puedes usar para acceder a las soluciones a las que se pueden añadir comentarios. Lee la documentación con atención, porque hay muchos matices si quieres hacerlo bien.

¿Qué queda por hacer?

Hay algunas funcionalidades nuevas para los Representers que iremos lanzando a lo largo de las próximas semanas y meses. Publicaremos información en nuestro foro (como esta publicación sobre cómo actualizar los Representers), así que no le pierdas la pista.

Cómo crear un Representer

Si te interesa crear un Representer, echa un vistazo a la documentación de los Representers para obtener más información, o abre un tema nuevo en nuestro foro si quieres hacer preguntas.