Discussion: What approach to use for migrating extensions
まだ誰も着手していません。
評価
- 難易度
- 5/5
- 見積もり時間
- 1週間以上
- 初心者へのやさしさ
- 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時間
- マージ済み PR（30日）
- 5
環境構築
このプロジェクトの環境構築ファイルはまだ確認していません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- 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
-
area:kubernetes source:reader type:content-error
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
stephrobert/blog-roadmap#24 ·
-
Link Checker Reportオープンautomated issue report
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
-
documentation
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
PedestrianDynamics/pyFDS-Evac#342 ·
メンテナーはふだん 1 日以内に返信
-
Docs Timedelta
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
pandas-dev/pandas#69919 ·
メンテナーはふだん 1 日以内に返信
-
難易度 1/5 1時間未満 初心者へのやさしさ 90/100
supabase/agent-skills#614 ·