typelevel / typelevel/typelevel.github.com

"Onboarding" experience site for TL?

Aberta
#595 2 comentários 0 reações 0 responsáveis Ver no GitHub

Ninguém assumiu esta issue ainda.

Linguagem predominante
HTML
Estrelas
42
Forks
115
Merge médio
5d 5h
PRs com merge (30d)
7

Descrição

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.)

Guia de contribuição

Abrir o guia de contribuição

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Direção de pesquisa

Comece revisando os tutoriais atuais e o site de onboarding do Unison em https://share.unison-lang.org/. Identifique um pequeno conjunto de introduções representativas de projetos TL e delineie a UX e a arquitetura da informação necessárias para elas. O trabalho estará concluído quando o projeto tiver um escopo de onboarding concreto e acordado, em vez de apenas uma proposta geral.

Escrita pelo modelo de indexação a partir do texto da issue.

Avaliação

Stack de tecnologia
html
Domínio
design, documentation, web-dev
Tipo de issue
Funcionalidade
Dificuldade
5/5
Tempo estimado
Mais de uma semana
Status de atividade
Estagnada
Clareza
Precisa de esclarecimento
Facilidade para iniciantes
25/100

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.