Junho nhận ra vấn đề lớn nhất không phải là lỗi kỹ thuật mà là không có documentation.
Mọi kiến thức về pháp trận và phép thuật chỉ tồn tại trong đầu người, hoặc ghi chép rải rác không có cấu trúc. Không có cách nào để người mới học hiểu hệ thống một cách có hệ thống — phải dành năm này qua năm khác học từ người đi trước, học bằng bắt chước hơn là bằng hiểu.
Trong lập trình, loại vấn đề này được gọi là “tribal knowledge” và nó luôn là nguồn gốc của những lỗi tệ nhất.
Anh bắt đầu lập tài liệu.
“Mỗi loại pháp trận cần có: mô tả mục đích, danh sách node, sơ đồ luồng linh lực, điều kiện kích hoạt, điều kiện lỗi và cách xử lý.”
Elara nhìn bản mẫu anh soạn: “Anh định viết tài liệu cho tất cả pháp trận của thành à?”
“Không phải mình tôi. Mọi người cùng viết, tôi chỉ đặt tiêu chuẩn và hướng dẫn cách viết.”
“Sẽ mất rất lâu.”
“Nhưng sau đó, người mới học sẽ không cần tốn mấy năm chỉ để hiểu cơ bản. Họ đọc tài liệu trong một tuần rồi bắt đầu làm việc thực tế. Thời gian tổng thể ngắn hơn nhiều.”
Elara nhìn anh một lúc, tay nhìn vào bản mẫu.
Truyện liên quan
“Anh thật sự không phải dân phép thuật.”
“Tôi là lập trình viên.” Anh nhún vai. “Khác nhau không nhiều ở phần này.”
Cô cầm bản mẫu lên, đọc kỹ từng mục. Rồi lấy giấy và bắt đầu viết tài liệu cho pháp trận đầu tiên cô phụ trách.
Việc lập tài liệu bắt đầu tạo ra thay đổi anh không ngờ: các pháp sư bắt đầu đặt câu hỏi cho nhau nhiều hơn.
Trước đây, mỗi người giữ kiến thức riêng. Khi cần sửa pháp trận của người khác, phải hỏi thẳng người đó, và người đó đôi khi giải thích không rõ vì chưa bao giờ phải diễn đạt kiến thức của mình thành lời.
Bây giờ, kiến thức được ghi lại theo chuẩn thống nhất. Người cần thông tin đọc tài liệu trước, rồi hỏi câu hỏi cụ thể hơn, và câu trả lời cũng cụ thể hơn.
Elara ghi nhận điều đó trong báo cáo tuần cho thành chủ: “Thời gian xử lý vấn đề pháp trận giảm trung bình 40% trong hai tuần qua.”
Đó là con số cô đo được, không phải ước tính.
Junho đọc báo cáo đó và nghĩ: documentation không chỉ là ghi chép — đó là hạ tầng giao tiếp. Khi mọi người nói cùng ngôn ngữ, họ cộng tác tốt hơn mà không cần nhiều họp hành.
Chưa có bình luận cho chương này.