bytecodealliance / bytecodealliance/component-docs
A section on the implications of including worlds
- 主要语言
- Rust
- 星标
- 137
- 派生
- 88
- 平均合并
- 5 天 12 小时
- 30 天内合并 PR
- 4
描述
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.
贡献指南
调研方向
阅读链接的 issue #245 和 #240,以及现有的 worlds 子章节,以了解围绕包含 wasi:http/proxy 所报告的困惑。完成的标准是文档清楚地解释 include 用于定义一个超集 world,并区分导入功能与实现导出的接口。
由索引模型根据 Issue 内容生成。
评估
- 技术栈
- rust, wasm
- 领域
- documentation
- Issue 类型
- 文档
- 难度
- 3/5
- 预计耗时
- 1-2 天
- 活跃度
- 停滞
- 描述清晰度
- 需要澄清
- 新手友好度
- 35/100