Hacktoberfest 2026: as issues que os mantenedores marcaram para outubro, abertas e boas para iniciantes. Ver issues do Hacktoberfest

Improve accessibility of project/tutorial project templates

Aberta
  • Algo errado?
#241 4 comentários 0 reações 0 responsáveis Ver no GitHub

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
5/5
Tempo estimado
Mais de uma semana
Facilidade para iniciantes
25/100
Tipo de issue
Funcionalidade
Clareza
Precisa de esclarecimento
Status de atividade
Estagnada
Stack de tecnologia
javascript, python, rust, wasm
Domínio
developer-experience, documentation, tooling

Direção de pesquisa

Comece revisando o layout do repositório component-docs e a proposta na issue #219; em seguida, compare as opções descritas aqui de um único repositório de nível superior, tarballs de Current-release e scaffolding específico por linguagem. Defina um caminho de configuração acordado para os recursos dos tutoriais e verifique se ele cobre os workflows mencionados de Rust, JavaScript e Python sem exigir que os usuários naveguem por um subdiretório aninhado.

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

Descrição

Currently, new users must clone the component-docs repo, head to a specific sub-directory then attempt to build projects.

It would be ideal if there were easier ways to download and set up resources to walk through the tutorials.

While we probably want to avoid building custom tooling in every possible language (different languages have different scaffolding mechanisms), we need a solution that is a bit less nested.

There were several good suggestions made, one of which being a single repo that contains all the languages at the top level (thanks @mkatychev), which is a bit easier to clone and filter out.

Another suggestion is that this could actually be a part of #219 -- having a "Current" release that always contains tarballs of the current code for any given language might make it easy to download and extract (ex. rust-starter.zip or js-starter.zip).

We could also rely on language-specific templating functionality, but this would likely require ensuring that it exists in the first place for all related languages (i.e. cargo component new, jco new, componetize-py new, etc), or in a shared tool like wit-bindgen which may not be feasible.

Linguagem predominante
Rust
Estrelas
138
Forks
89
Merge médio
2d 6min
PRs com merge (30d)
1

Preparar o ambiente

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.

Mais de bytecodealliance/component-docs

Todas as issues de bytecodealliance/component-docs

Issues semelhantes

Mais issues de Rust

Receba novas issues na sua caixa de entrada

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