Document Aspire 17 required-parameter migration
维护者通常 2 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 3/5
- 预计耗时
- 1-2 天
- 新手友好度
- 68/100
- Issue 类型
- 文档
- 描述清晰度
- 描述清楚
- 活跃度
- 活跃
- 技术栈
- csharp, typescript
调研方向
Read the existing troubleshooting guidance at docs/tips-and-known-issues.md#aspire-17-intentionally-empty-parameter-values and reconcile it with the merged implementation and linked Aspire changes. When the Aspire 17 release or migration page is added to the website's main tree, write the note there and link the existing external-parameters guidance. Cover required values and startup recovery, optional parameter behavior in C# and TypeScript, and the manifest publisher limitation; done means the migration guidance reflects current behavior without creating a standalone page.
由索引模型根据 Issue 内容生成。
描述
Add an Aspire 17 What's New migration note for the required-parameter change introduced by aspire#18108, including the interactive startup recovery in draft aspire#22124. The original report is aspire#21795.
Keep the required null/empty validation; this is migration guidance, not a request to revert it. Parameters are required by default, and an explicit "" no longer satisfies a required value. Cover ordinary, secret, and connection-string parameters.
The note should explain:
- Supply a nonempty value for required parameters. When Dashboard interaction is available, missing required startup values can be supplied in Parameters; without interaction, initialization fails with a
MissingParameterValueExceptionnaming the parameter. - If an empty or absent value is genuinely valid, use
.WithOptional()in C# or.withOptional()in TypeScript. An explicit empty optional value remains""; an unset optional value resolves tonulland is omitted when used as an environment variable. Do not make required credentials optional just to suppress validation. - In TypeScript, omitting
valueor supplyingvalue: nulluses parameter configuration; it does not override a configured value with an empty string. - The manifest publisher does not currently support optional parameters. Do not present optionality as a workaround for required deployment values.
The draft's troubleshooting guidance has the examples and current behavior. Reconcile this note with the merged implementation before publication.
The website's complete main tree has no Aspire 17 release/migration page as of November 11, 2026. Add this to that page when it is created and link the existing external-parameters guidance; this follow-up does not require creating a standalone Aspire 17 page now. Website publication should not block the code fix.
- 主要语言
- MDX
- 星标
- 202
- 派生
- 99
- 平均合并
- 2 天 10 小时
- 30 天内合并 PR
- 97
环境准备
在浏览器里用你自己的 GitHub 账号启动这个项目的开发容器。
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
microsoft/aspire.dev 的其他 Issue
-
难度 2/5 1-3 小时 新手友好度 82/100
microsoft/aspire.dev#2131 ·
维护者通常 2 天内回复
-
难度 2/5 1-3 小时 新手友好度 85/100
microsoft/aspire.dev#2130 · 1 个 reaction ·
维护者通常 2 天内回复
-
难度 1/5 1-3 小时 新手友好度 82/100
microsoft/aspire.dev#2129 ·
维护者通常 2 天内回复
-
Docs: note that Bun resources don't trust the dev cert via NODE_EXTRA_CA_CERTS (upstream Bun bug)未关闭
难度 2/5 1-3 小时 新手友好度 88/100
microsoft/aspire.dev#1802 · 3 条评论 ·
维护者通常 2 天内回复
-
[docs] Missing information about the dotnet container steps around image being built locally可能已有人在做 @IEvangelist 于 54 天前认领。 未关闭
难度 2/5 1-3 小时 新手友好度 72/100
microsoft/aspire.dev#1288 · 1 个 reaction · 已指派 2 人 ·
维护者通常 2 天内回复
查看 microsoft/aspire.dev 的全部 Issue
相似的 Issue
-
area:mcp effort:low P5 source:agent
难度 2/5 1-3 小时 新手友好度 78/100
维护者通常 1 天内回复
-
README says the land/sea mask must match the XS grid; the demo mask does not, and Step 4 works可能已有人在做 关联的 PR 仍在进行中或已合并。 未关闭documentation
难度 2/5 1-3 小时 新手友好度 72/100
buckai-observatory/Automated-Cloud-Removal-and-Seamless-Satellite-Image-Mosaicking-Pipeline#52 ·
维护者通常 1 天内回复
-
documentation
难度 1/5 1-3 小时 新手友好度 84/100
维护者通常 1 天内回复
-
难度 1/5 1-3 小时 新手友好度 82/100
run-llama/llama_index#24163 ·
维护者通常 1 天内回复
-
documentation good first issue severity: low
难度 2/5 1-3 小时 新手友好度 83/100
TMHSDigital/Static_Chess#48 ·