Handling of deprecated / hidden commands `hydrate` & `prepare`
还没有人认领这个 Issue。
评估
- 难度
- 4/5
- 预计耗时
- 3-5 天
- 新手友好度
- 38/100
- Issue 类型
- 文档
- 描述清晰度
- 基本清楚
- 活跃度
- 停滞
- 技术栈
- typescript
- 领域
- cli, documentation
调研方向
从 README 以及现有的 corepack hydrate --help 和 corepack prepare --help 输出开始。检查与命令相关的文档以及已弃用命令的帮助文本，然后将完成标准定义为：记录它们的状态和迁移路径，在帮助输出中相应标注，并在确定相关入口点后添加所请求的弃用警告。
由索引模型根据 Issue 内容生成。
描述
Issue
-
The following commands are hidden since PR https://github.com/nodejs/corepack/pull/291 implemented https://github.com/nodejs/corepack/issues/274 in release [email protected]:
corepack hydratecorepack prepare
These commands:
- are not documented in the README
- have no migration guide to their replacement commands
- do not appear in the output of
corepack --help - are described in the output of
corepack hydrate --helpandcorepack prepare --help - neither their usage, nor their help text indicates that the commands are deprecated
Several issues lately have shown users reporting problems when executing corepack prepare.
corepack prepare is listed as a valid command in Node.js documentation Corepack latest v18v22 & v23 describes instead corepack use / corepack install. Edit: v22 and v24 documentation now have no detailed content.)
Suggestion
- Describe the above commands as deprecated and either add
thea migration tablefrom https://github.com/nodejs/corepack/issues/274to the README or create a separate Migration Guide document. Edit: the migration table in the PR contains inaccuracies and cannot be used as it stands. - Extend the help text for the commands to indicate that they are deprecated.
- Output a deprecation warning if deprecated commands are used.
Also review Node.js documentation Corepack latest v18 and initiate an update if possible. Edit: Node.js 18 has passed into end-of-life status, so all related assets are now frozen.
Related Node.js documentation
- Node.js 18 Corepack (Node.js 18 is end-of-life)
- Node.js 20 Corepack
- Node.js 22 Corepack
- Node.js 24 Corepack
- Node.js latest Corepack
- 主要语言
- TypeScript
- 星标
- 3.8k
- 派生
- 279
- 平均合并
- 1 小时 47 分钟
- 30 天内合并 PR
- 2
环境准备
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
nodejs/corepack 的其他 Issue
-
难度 2/5 1-3 小时 新手友好度 64/100
-
难度 2/5 1-3 小时 新手友好度 72/100
-
难度 4/5 3-5 天 新手友好度 68/100
-
难度 3/5 1-2 天 新手友好度 52/100
-
难度 3/5 1-2 天 新手友好度 68/100
相似的 Issue
-
refactor
难度 2/5 半天 新手友好度 84/100
维护者通常 5 天内回复
-
难度 2/5 1-3 小时 新手友好度 72/100
OHDSI/Data2Evidence#3450 ·
维护者通常 2 天内回复
-
e2e-failure ready-to-code
难度 2/5 1-3 小时 新手友好度 90/100
redhat-developer/rhdh-plugin-export-overlays#4011 · 1 条评论 ·
维护者通常 1 天内回复
-
automation missing-model model-sync provider:ofox
难度 2/5 1-3 小时 新手友好度 72/100
anomalyco/models.dev#8421 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 76/100
维护者通常 1 天内回复