encodedKey indexing out of sync in docs/CaskSecret.md
还没有人认领这个 Issue。
评估
- 难度
- 1/5
- 预计耗时
- 1 小时以内
- 新手友好度
- 55/100
- Issue 类型
- 文档
- 描述清晰度
- 描述清楚
- 活跃度
- 停滞
调研方向
打开 docs/CaskSecret.md 的第 84–91 行附近，并将 encodedKey 表与 issue 中提供的修正后结尾进行比较。更新索引、右方括号和范围表示法，使最后一个字符为 encodedKey[63]，总数为 64 个字符。当 URL-safe Base64 示例的表在内部保持一致时，即表示完成。
由索引模型根据 Issue 内容生成。
描述
In https://github.com/microsoft/cask/blob/main/docs/CaskSecret.md#url-safe-base64-encoded-rendering-example-for-256-bit-key-no-optional-data, the indexing of encodedKey goes out of sync after <12-bits-reserved> "AA":
It shows the time-of-allocation second at encodedKey[64], but that should instead be at encodedKey[63] so that the size of the whole thing is 64 characters and it evenly translates to 64/4*3 = 48 bytes.
Also, there is a closing bracket missing, and the 'a'..'e' range should use ... rather than .. because it's meant to include 'e'.
The table should end like this:
| String Range | Text Value | Description |
|---|---|---|
| … | … | … |
| encodedKey[52..56] | 'TEST' | Provider fixed signature. |
| encodedKey[56..58] | 'AA' | Reserved encoded zero characters. |
| encodedKey[58] | 'A'...'_' | Time-of-allocation year, 'A' (2025) to '_' (2088) |
| encodedKey[59] | 'A'...'L' | Time-of-allocation month, 'A' (January) to 'L' (December) |
| encodedKey[60] | 'A'...'Z'|'a'...'e' | Time-of-allocation day, 'A' (0) to 'e' (31) |
| encodedKey[61] | 'A'...'X' | Time-of-allocation hour, 'A' (hour 0 or midnight) to 'X' (hour 23). |
| encodedKey[62] | 'A'...'7' | Time-of-allocation minute, 'A' (0) to '7' (59). |
| encodedKey[63] | 'A'...'7' | Time-of-allocation second, 'A' (0) to '7' (59). |
- 主要语言
- C#
- 星标
- 6
- 派生
- 5
- PR 合并指标
- 30 天内没有已合并 PR
环境准备
这个项目没有提供开发容器、Dockerfile 或贡献指南，环境需要你自己搭建：先看它的 README，通用步骤见我们的新手贡献指南。
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
microsoft/cask 的其他 Issue
-
难度 1/5 1 小时以内 新手友好度 72/100
-
难度 1/5 1 小时以内 新手友好度 55/100
-
难度 2/5 1-3 小时 新手友好度 45/100
-
难度 4/5 3-5 天 新手友好度 35/100
-
Avoid encode/decode round-trips in IsCask可能重新可做 @nguerrera 于 563 天前认领，目前没有进行中的 PR。 未关闭
相似的 Issue
-
good first issue help wanted
难度 2/5 1-3 小时 新手友好度 65/100
-
untriaged
难度 2/5 1-3 小时 新手友好度 72/100
dotnet/dotnet-api-docs#13210 ·
维护者通常 1 天内回复
-
aspnet-core/svc doc-enhancement mvc/subsvc Pri2
难度 2/5 1-3 小时 新手友好度 72/100
dotnet/AspNetCore.Docs#38016 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 64/100
HicServices/RDMP#2398 ·
-
area-drawing platform/android t/bug
难度 2/5 1-3 小时 新手友好度 70/100
dotnet/maui#39676 · 1 条评论 · 1 个 reaction ·
维护者通常 1 天内回复