GitHub issue artifacts: kế hoạch có chỗ ở ngoài luồng bình luận
Mã nằm trong pull request nhưng lý do có thể chìm trong cuộc trò chuyện cũ. Nếu nghiên cứu của tác nhân nằm nơi khác, người tiếp quản dễ phải làm lại. Ngày 28/10, GitHub giới thiệu bản xem trước công khai của issue artifacts để gắn bối cảnh trực tiếp vào issue.
Hội thoại và tài liệu cập nhật có vai trò khác nhau
Artifact có thể là Markdown, liên kết ngoài hoặc HTML: phân tích nguyên nhân, nguyên mẫu hay thảo luận Slack và Teams. Trên github.com có thể tạo, sửa và giữ lịch sử phiên bản. Chúng khác artifact của GitHub Actions, vốn là đầu ra của lần chạy workflow.
Hãy hình dung lỗi thanh toán hai lần trong ví dụ giả định. Bình luận ghi quan sát mới; kế hoạch ghi khóa thử lại và thí nghiệm còn bỏ ngỏ. Hình đầu được tự làm cho bài viết, không phải màn hình GitHub. Tách quan sát khỏi giả thuyết giúp tránh biến suy đoán thành yêu cầu.
Đính kèm tệp rồi tiếp tục duy trì bối cảnh
gh issue artifact create nhận số hoặc URL issue rồi đến tệp hay liên kết. gh issue artifact create 42 retry-plan.md -R OWNER/REPO sẽ gắn tệp vào issue 42. Đây là giá trị mẫu; chạy lệnh sẽ ghi vào issue. Bài viết không thực thi lệnh này.
Tên có thể lấy từ tệp hoặc --name. --body-file đọc nội dung một tài liệu; --attach hỗ trợ ảnh và video. gh issue artifact edit 42 1 --body-file retry-plan.md -R OWNER/REPO thay nội dung. Hình thứ hai minh họa cú pháp, không phải nhật ký tải lên thành công.
Kế hoạch hiện tại vẫn giữ được lịch sử
edit đổi tên hoặc nội dung chứ không đổi loại. --restore-version lưu tên và nội dung cũ thành phiên bản mới; view hiển thị lịch sử sửa. Có thể giữ kế hoạch mới mà không xóa đường đi đến quyết định.
Ở ví dụ thanh toán, nghi ngờ có thể chuyển từ timeout sang xử lý khóa trùng. Cập nhật kế hoạch và nối bình luận giải thích là đề xuất tổ chức tài liệu, không phải hành vi tự động được bảo đảm. Tài liệu đính kèm vẫn cần bằng chứng cho kết luận.
HTML được hỗ trợ khác nhau tùy giao diện
Thông báo mô tả chuyển giữa bản xem HTML và mã nguồn. Nhưng tạo và xem HTML trong GitHub App được ghi là sắp có. Tự động gắn kết quả phiên làm việc không đồng nghĩa hỗ trợ HTML đầy đủ ở mọi nơi. CLI cũng còn ở bản xem trước.
Giá trị nằm ở chỗ tìm được bối cảnh gần công việc, không phải số tài liệu. Một kế hoạch sẵn có và lần sửa tiếp theo đủ để thử quy trình. Các nguồn chính thức bên dưới nêu phạm vi hiện tại.