Lộ trình 07Bài học 2 / 8

Đưa codebase hiện có vào Taiga

Review những gì Taiga suy ra từ repository. Phân biệt hành vi hiện tại với hành vi dự kiến và chọn cách xử lý đúng khi tài liệu không chính xác.

Thực hành11 minĐã review

Xuất bản bởi Cách chúng tôi viết

Kiểm tra mức hiểuTài liệu import mô tả chính xác mã mà bạn định thay thế. Cách xử lý phù hợp là gì?Làm bài tập
Tài liệu import mô tả chính xác mã mà bạn định thay thế. Cách xử lý phù hợp là gì?

Bạn sẽ học gì

  • Chuẩn bị repository được liên kết cho sản phẩm import.
  • Phân biệt lỗi mã, hướng dẫn lâu dài và lỗi phân tích.
  • Review initiative đề xuất dựa trên thiếu sót thực tế và năng lực hiện có.

Bắt đầu từ hệ thống đang có

Dịch vụ yêu cầu thiết bị giả định đã tồn tại. Nhóm muốn bảo trì với Taiga đồng thời giữ các tích hợp đang hoạt động.

Chọn Import codebase khi tạo sản phẩm. Liên kết repository và bắt đầu phân tích. Lộ trình này dùng phân tích repository thay hội thoại sản phẩm mới. Sản phẩm tạo từ đầu không bổ sung lộ trình import này về sau.

Xác nhận quyền truy cập repository và branch Taiga cần làm việc trên đó. Thêm ràng buộc lâu dài ở cấp ngữ cảnh phù hợp. Với ví dụ này, nêu tích hợp danh tính nhân viên hiện có phải tiếp tục được dùng.

Review đặc tả suy ra trước

Taiga suy ra tài liệu sản phẩm từ mã và kèm trích dẫn repository. Những trích dẫn giúp kiểm tra cách diễn giải. Chúng không xác lập ý định kinh doanh đằng sau mọi mẫu hiện có.

Kiểm tra ba điều trong đặc tả:

  • Mục đích: Mục tiêu mô tả có khớp lý do dịch vụ tồn tại không?
  • Ràng buộc: Mẫu nào là yêu cầu có chủ ý?
  • Lỗi đã biết: Hành vi hiện tại nào cần đổi?

Dịch vụ thiết bị chứa module phân quyền cũ. Tài liệu có thể báo chính xác việc sử dụng module. Điều đó không có nghĩa nhóm nên mở rộng nó.

Mở tệp được trích dẫn và so sánh hành vi liên quan với nhận định. Ghi giới hạn bằng chứng sẵn có, chẳng hạn cấu hình hoặc hành vi vận hành nằm ngoài repository.

Chọn cách sửa đúng

Tình huốngCách xử lý
Tài liệu mô tả đúng mã không mong muốnLập kế hoạch và thực hiện thay đổi mã
Nhóm có quy tắc lâu dài cho công việc tương laiĐặt quy tắc vào instructions sản phẩm
Phân tích hiểu sai repositoryDùng Refresh this document và kiểm tra kết quả

Tài liệu import theo mã. Không xem chúng là mô tả hệ thống tương lai được duy trì thủ công. Refresh tài liệu cũng suy ra lại những tài liệu mà nó phụ thuộc. Vì vậy, refresh tài liệu phía sau có thể cần nhiều công việc hơn.

Với module cũ, hướng dẫn có thể ghi: “Không thêm bên gọi mới vào module phân quyền cũ. Dùng giao diện thay thế đã được phê duyệt cho công việc mới.” Xác minh giao diện tồn tại và nêu vị trí repository thực tế.

Đánh giá các initiative đầu tiên

Quy trình import cũng chạy quét repository, đánh giá theo chính sách đã xuất bản và lập kế hoạch initiative ban đầu. Giai đoạn thiếu điều kiện tiên quyết có thể được bỏ qua kèm giải thích. Lập kế hoạch dùng phát hiện và đánh giá chính sách sẵn có.

Đối chiếu thiếu sót được đề xuất với repository. Initiative ban đầu xử lý năng lực còn thiếu, nền tảng hoặc vấn đề dependency liên quan chưa giải quyết. Chúng không phải danh sách tính năng mới không ai yêu cầu.

Giữ năng lực hiện có hữu ích. Từ chối hoặc sửa đề xuất sẽ xây lại nó không cần thiết. Thêm initiative riêng cho yêu cầu kinh doanh mới.

Giữ điểm khởi đầu dựa trên bằng chứng

Hoàn tất Discovery và review đề xuất initiative. Xác nhận môi trường và trách nhiệm bàn giao trước khi lập kế hoạch chi tiết. Giữ nội dung import, thay đổi mã và instructions sản phẩm nhất quán trong khi làm việc.

Kết quả là điểm khởi đầu đã hiểu và backlog có thể chỉnh sửa. Không phải tuyên bố mọi hành vi hiện có đều đúng. Tiếp tục với lập kế hoạch initiative.

Làm bài tập

Dịch vụ giả định được import dùng module phân quyền cũ. Việc thay thế đã được lên kế hoạch. Viết hướng dẫn sản phẩm ngăn tạo phụ thuộc mới vào module. Sau đó xác định một trích dẫn repository bạn sẽ kiểm tra trong đặc tả import.

Tải worksheet (Markdown)
Kiểm tra mức hiểu ↑

Tiếp tục học

Nguồn và đọc thêm

Đọc thêm liên quan từ Taiga

← Bài trước: Bắt đầu sản phẩm mới trong Taiga