bytecodealliance / bytecodealliance/component-docs

A section on the implications of including worlds

Aberta
#246 0 comentários 0 reações 0 responsáveis Ver no GitHub
Linguagem predominante
Rust
Estrelas
137
Forks
88
Merge médio
5d 12h
PRs com merge (30d)
4

Descrição

In https://github.com/bytecodealliance/component-docs/issues/245 a user encountered a bump when trying to import functionality from `wasi:http` that I'd guess will occur again.

Not sure if this belongs in the subsection on worlds, since it could also be part of https://github.com/bytecodealliance/component-docs/issues/240, or there could perhaps be a section that pertains to all guest languages, as it probably isn't unique to the rust experience.

The user included `wasi:http/proxy` and didn't realize that they would have to implement the interfaces exported by it, as they were really only after importing the functionality that that world provided, and had no intention of authoring a component that exported any of it's functionality. Ideally we would clearly inform users to reserve `include` usage for when they want to define a world that is a superset of another.

Guia de contribuição

Abrir o guia de contribuição

Direção de pesquisa

Leia as issues vinculadas #245 e #240 e a subseção existente sobre worlds para entender a confusão relatada em torno da inclusão de wasi:http/proxy. Considera-se concluído quando a documentação explicar claramente que include serve para definir um world superconjunto e distinguir entre importar funcionalidade e implementar interfaces exportadas.

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

Avaliação

Stack de tecnologia
rust, wasm
Domínio
documentation
Tipo de issue
Documentação
Dificuldade
3/5
Tempo estimado
1-2 dias
Status de atividade
Estagnada
Clareza
Precisa de esclarecimento
Facilidade para iniciantes
35/100

Receba novas issues na sua caixa de entrada

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