typelevel / typelevel/typelevel.github.com

"Onboarding" experience site for TL?

Abierto
#595 2 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Lenguaje dominante
HTML
Estrellas
42
Forks
115
Merge medio
5 d 5 h
PR fusionados (30 d)
7

Descripción

Folks have observed that Unison has an excellent site for helping folks get started with the language, under https://share.unison-lang.org/

At least in principle, it would be great if we had something similar: some paint-by-numbers introductions that go beyond the current tutorials and ease the path of getting oneself started with TL projects.

This is a fairly tall order, not least because there are so many different kinds of potential TL projects: there's probably no one-size-fits-all starting points. But a few solid examples might be really helpful.

(Note that this isn't just a code-plus-text project: well-thought-out UX and information architecture are likely to also matter.)

Guía de contribución

Abrir la guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Línea de trabajo

Empieza revisando los tutoriales actuales y el sitio de onboarding de Unison en https://share.unison-lang.org/. Identifica un pequeño conjunto de introducciones representativas de proyectos de TL y describe la UX y la arquitectura de la información necesarias para ellas. Se considera terminado cuando el proyecto tenga un alcance de onboarding concreto y acordado, en lugar de solo una propuesta general.

Escrito por el modelo de indexación a partir del texto del issue.

Evaluación

Stack tecnológico
html
Área
design, documentation, web-dev
Tipo de issue
Nueva funcionalidad
Dificultad
5/5
Tiempo estimado
Más de una semana
Estado de actividad
Estancado
Claridad
Necesita aclaración
Aptitud para principiantes
25/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.