Document available Radius AI tooling and define its productization path
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 5/5
- 预计耗时
- 一周以上
- 新手友好度
- 35/100
- Issue 类型
- 文档
- 描述清晰度
- 基本清楚
- 活跃度
- 活跃
调研方向
Start with the existing GitHub Copilot app integration guide and the public source repositories for Radius skills, plugins, and integrations. Verify each host’s capabilities, installation, release status, prerequisites, and limitations before writing the inventory and workflow guidance. Done means the docs include validated setup and application-modeling steps, clearly label preview and proposed work, and link a productization proposal and implementation issues owned by the tooling repositories.
由索引模型根据 Issue 内容生成。
描述
What content needs to be created or modified?
Developers need a clear account of the AI tooling available for adopting Radius: what it does, where to obtain it, how to install and use it, and which capabilities are supported in each host. The existing GitHub Copilot app integration documentation provides one entry point, but it should not be treated as evidence that the same capabilities are available in every AI tool.
This work includes both documentation of available capabilities and a scoped productization proposal for gaps in packaging, distribution, and reuse. Documentation must distinguish released functionality, preview features, and proposed work.
Describe the solution you'd like
Document what exists
- Inventory available Radius skills, plugins, and integrations from their source repositories. Record their capabilities, installation source, host requirements, release status, limitations, and maintenance owner.
- Explain the distinction between reusable skills and host-specific UI or orchestration, including Radius Canvas in the GitHub Copilot app.
- Provide reproducible installation and first-use instructions for each validated host. Evaluate GitHub Copilot CLI and other AI tools as potential consumers of reusable skills, but list them as supported only after validation.
- Walk through using available tooling to inspect an application repository, generate or update an application definition such as
app.bicep, review the result, and validate it. Document later deployment steps only where the chosen integration actually supports them. - Explain credential handling, permissions, repository changes, review of generated infrastructure, cloud costs, and the points where users approve consequential operations.
Define the productization work
Write a short proposal and implementation backlog covering the source of truth for shared skills, host-specific adapters, packaging, versioning, installation, upgrades, testing, and support ownership. Compare reuse options before choosing a repository or dependency model; avoid maintaining duplicate skill instructions across hosts.
Track implementation gaps in the repositories that own the tooling and link them from this documentation issue. Do not present an unimplemented distribution or cross-host design as available functionality.
Acceptance criteria
- A verified inventory distinguishes available, preview, and proposed capabilities, with links to their public source and installation instructions.
- Host compatibility and prerequisites are explicit, including any cloud or application-structure limitations of each integration.
- A reader can install an available tool and complete a documented application-modeling workflow, with expected artifacts and validation steps.
- Generated files, human-review checkpoints, credential requirements, and troubleshooting are explained.
- A short productization proposal records the shared-skill/host-specific boundary, distribution and versioning approach, ownership, and unresolved decisions.
- Implementation work needed to close identified gaps is captured in linked issues in the owning repositories.
- The user-facing documentation is linked from Integrations and relevant application-authoring guidance; no unsupported cross-host or cloud parity is implied.
Where should the new material be placed?
Add a general AI tooling entry point under Integrations, linking to host-specific setup guides and the existing GitHub Copilot app integration. Keep productization decisions and implementation tracking with the tooling's owning repositories, and link their user-facing outcomes back to the docs.
The associated pull request from the Radius code repo, if applicable
N/A at issue creation. Identify and link the appropriate implementation PRs after the inventory and productization proposal establish ownership and scope.
Additional context
Related documentation work:
- #2078: dedicated AWS and Azure setup and module guidance.
- #2079: a canonical end-to-end application tutorial that can provide a consistent example for AI-assisted workflows.
The manual deployment tutorial should remain usable without AI tooling. This issue is not a request to promise a new agent platform or to declare every existing integration generally available; it is a request to document what works today and define a maintainable path for making the remaining tooling usable.
- 主要语言
- Bicep
- 星标
- 27
- 派生
- 51
- 平均合并
- 1 天 8 小时
- 30 天内合并 PR
- 37
环境准备
在浏览器里用你自己的 GitHub 账号启动这个项目的开发容器。
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
radius-project/docs 的其他 Issue
-
bug triaged
难度 1/5 1 小时以内 新手友好度 86/100
radius-project/docs#1953 ·
维护者通常 1 天内回复
-
triaged
难度 1/5 1 小时以内 新手友好度 68/100
radius-project/docs#1439 ·
维护者通常 1 天内回复
-
triaged
难度 2/5 1-3 小时 新手友好度 68/100
radius-project/docs#1224 · 6 条评论 ·
维护者通常 1 天内回复
-
triaged
难度 1/5 1 小时以内 新手友好度 70/100
radius-project/docs#1104 ·
维护者通常 1 天内回复
-
难度 5/5 一周以上 新手友好度 35/100
radius-project/docs#2079 ·
维护者通常 1 天内回复
查看 radius-project/docs 的全部 Issue
相似的 Issue
-
[workshop-sim] Repair: Make Copilot access and billing path decision self-contained in Steps 07/07d未关闭feedback simulation workshop
难度 2/5 1-3 小时 新手友好度 72/100
githubnext/gh-aw-workshop#5597 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 68/100
Icinga/icinga-notifications-web#645 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 78/100
line/centraldogma#1397 ·
维护者通常 2 天内回复
-
难度 2/5 1-3 小时 新手友好度 84/100
OpenMage/magento-lts#5865 ·
维护者通常 3 天内回复
-
难度 2/5 1-3 小时 新手友好度 65/100
elixir-europe/ds-handbook#190 ·