Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Discussion: What approach to use for migrating extensions

Đang mở
  • Có gì không ổn?
#13 11 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
25/100
Loại issue
Tính năng
Độ rõ ràng
Cần làm rõ
Mức độ hoạt động
Sôi nổi
Công nghệ
git, xml
Lĩnh vực
documentation

Hướng nghiên cứu

Bắt đầu với cuộc thảo luận về chiến lược này và issue gốc php/doc-extensions#11; không có tệp hoặc test nào được nêu tên. Xem xét đề xuất migration hàng loạt, việc bảo toàn lịch sử Git, các bản sửa entity DTD-to-XML và việc rà soát docbook-cs. Được xem là hoàn tất khi phương án migration đã được thống nhất và kế hoạch tiếp theo bao quát infrastructure và các redirect.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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).
Ngôn ngữ chính
XML
Star
2
Fork
6
Merge trung bình
1 ngày 14 giờ
Pull request đã merge (30 ngày)
5

Chuẩn bị môi trường

Chúng tôi chưa kiểm tra các tệp thiết lập môi trường của dự án này. Hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của php/doc-extensions

Tất cả issue của php/doc-extensions

Issue tương tự

Thêm issue về Documentation

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.