Discussion: What approach to use for migrating extensions
还没有人认领这个 Issue。
评估
- 难度
- 5/5
- 预计耗时
- 一周以上
- 新手友好度
- 25/100
- Issue 类型
- 功能
- 描述清晰度
- 需要澄清
- 活跃度
- 活跃
- 技术栈
- git, xml
调研方向
从这次策略讨论和最初的 php/doc-extensions#11 issue 开始；其中没有指定文件或测试。审查提议的批量迁移、Git 历史的保留、DTD-to-XML 实体修复，以及对 docbook-cs 的全面检查。当迁移方案达成一致，并且后续计划涵盖基础设施和重定向时，即视为完成。
由索引模型根据 Issue 内容生成。
描述
Moving this out of php/doc-extensions#11 as it allows for a bit more room to plan strategy regarding migrating the extensions. And might reach a more broad audience.
First of all, what would be the very best method of migrating all extensions.
All in bulk with shared git commit history
Individually with git history
Don’t care about the git history
The primary reason we should preserve git history is to not lose the credibility that previous contributors have done over the years.
Migrating extensions individually would give the benefit of having a better understanding of what’s going on, and allow fixing what’s broken more easily but it will break those commits as some commits may have touched multiple extensions. Which is not the most positive outcome for existing contributors.
The suggested approach I have in mind is:
- Migrate all extensions at once assuming it will break
- See what's broken
- Fix it (which likely will be DTD entities that we need to change to XML entities
Once that's done, I suggest we do a docbook-cs sweep so it will help contributors to make changes. We don't need to care about translators being overwhelmed by big changes.
Then finally we can prepare to publish this new doc-extensions repo by making a plan for:
- Infastructure
- Redirects
- Etc, etc (will be a separate discussion once we are more ready for it).
- 主要语言
- XML
- 星标
- 2
- 派生
- 6
- 平均合并
- 1 天 14 小时
- 30 天内合并 PR
- 5
环境准备
我们还没有检查这个项目的环境配置文件。先看它的 README，通用步骤见我们的新手贡献指南。
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
php/doc-extensions 的其他 Issue
-
enhancement
难度 2/5 1-3 小时 新手友好度 72/100
php/doc-extensions#23 ·
-
bug
难度 2/5 1-3 小时 新手友好度 78/100
php/doc-extensions#28 · 1 条评论 ·
-
难度 2/5 1-3 小时 新手友好度 78/100
php/doc-extensions#22 ·
-
难度 4/5 3-5 天 新手友好度 25/100
php/doc-extensions#27 ·
-
难度 3/5 1-2 天 新手友好度 35/100
php/doc-extensions#21 · 1 条评论 ·
查看 php/doc-extensions 的全部 Issue
相似的 Issue
-
docs pydanty:is-working
难度 2/5 1-3 小时 新手友好度 75/100
pydantic/pydantic-ai#8863 ·
维护者通常 1 天内回复
-
documentation from-review-extraction github-actions priority: low severity:nit
难度 1/5 1 小时以内 新手友好度 92/100
LearningCircuit/local-deep-research#6946 ·
维护者通常 1 天内回复
-
enhancement
难度 1/5 1 小时以内 新手友好度 88/100
esphome/device-builder#2856 ·
维护者通常 1 天内回复
-
documentation good first issue
难度 1/5 1 小时以内 新手友好度 95/100
-
难度 1/5 1-3 小时 新手友好度 78/100
mantinedev/mantine#9223 ·
维护者通常 6 天内回复