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

Docs changes needed when 2.0 goes stable

Đang mở Phù hợp với người mới
  • Có gì không ổn?
#596 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

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

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
91/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Lĩnh vực
documentation

Hướng nghiên cứu

Sau khi 2.0 stable tag tồn tại, hãy cập nhật các phần được liệt kê trong install.md, update.md và extend/update-2_0.md. Bắt đầu bằng cách xem xét sáu mục đã đánh dấu và các routine hiện có của bảng lưu trữ trong các issue #580, #582 và #583. Được xem là hoàn tất khi các cảnh báo release-candidate và cài đặt beta đã được xóa hoặc cập nhật, bảng lưu trữ phản ánh stable tag, và các bước vẫn được đánh số chính xác.

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

Mô tả

Several pages are written for the release-candidate period and become wrong the moment 2.0 is tagged stable. Collecting the exact spots here so they can be ticked off on release day rather than found afterwards. If this is already tracked somewhere I cannot see, ignore me.

  • install.md, the :::warning near the top: "Flarum 2.0 is in its release-candidate phase ... it isn't the final stable release yet, so back up your data and test before relying on it."
  • install.md, the install command: composer create-project flarum/flarum:^2.0.0 --stability=beta . no longer needs --stability=beta.
  • install.md, the archive table, which currently lists 2.0.0-rc.8 across twelve rows. This already has a routine (#580, #582, #583), so presumably one more run of it against the stable tag.
  • update.md, the matching :::warning at the top of the page.
  • update.md, step 5 "Set minimum-stability to beta". Its own :::info already tells people to change it back to stable once 2.0 is out, so the step itself probably wants removing, which renumbers steps 6 to 8.
  • extend/update-2_0.md: "Set flarum/core package requirement to ^2.0.0-beta" becomes ^2.0.

Two optional notes while in the area:

  • releases.md is currently a heading plus a link to the forum, with an older TODO commented out above it. A stable release seems like the moment that page gets attention, if it is going to.
  • Nothing appears to be needed for the Docusaurus versioning itself: docs/ is already the current version labelled 2.x with 1.x archived alongside it, which is the right shape for a stable 2.0.

The first six are all mechanical. I am happy to open that PR once the tag exists if it saves anyone the trouble, just say so.

Ngôn ngữ chính
JavaScript
Star
77
Fork
138
Merge trung bình
15 giờ 5 phút
Pull request đã merge (30 ngày)
81

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

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 flarum/docs

Tất cả issue của flarum/docs

Issue tương tự

Thêm issue về JavaScript

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.