Để tri thức ở lại và tự động hóa có kiểm soát
Khi chỉ một người biết hồ sơ ở đâu hoặc công cụ hoạt động thế nào, tổ chức đang phụ thuộc vào trí nhớ cá nhân. Quản lý tri thức giúp người khác tìm, hiểu và tiếp tục công việc, kể cả khi người phụ trách vắng mặt.
Tài liệu phải giúp làm được việc
Chọn những nội dung cần ghi: cách bắt đầu, cách xử lý công việc thường gặp, quyết định quan trọng, điều kiện vận hành và cách ứng phó khi có lỗi. Mỗi tài liệu cần có người phụ trách, phạm vi, thời điểm cập nhật và nơi nhận phản hồi. Tài liệu cũ không được phân biệt với tài liệu đang dùng có thể nguy hiểm hơn việc chưa có hướng dẫn.
Viết theo nhu cầu người đọc. Người mới cần đường đi và ví dụ; người vận hành cần điều kiện, dấu hiệu lỗi và cách khôi phục; người quản lý cần rủi ro và lựa chọn. Chụp màn hình có thể hỗ trợ nhưng không nên thay toàn bộ nội dung chữ, vì khó tìm kiếm và dễ lỗi thời.
Chia sẻ để có người làm thay
Tổ chức làm kèm, trao đổi chuyên môn và hướng dẫn lại bằng tình huống thực. Sau một buổi chia sẻ, kiểm tra người khác có thực hiện được hay chưa. Ghi bài học vào nơi cả nhóm dùng thay vì để trong tài khoản riêng.
Trước khi đưa tài liệu ra ngoài, kiểm tra quyền sử dụng, dữ liệu cá nhân và thông tin thương mại. Một bài học hữu ích có thể được viết lại bằng tình huống giả định đã ghi rõ, không cần tiết lộ tên người hay chi tiết dự án.
Phân biệt phiên bản mã nguồn và phiên bản hồ sơ
Với mã nguồn, hệ thống kiểm soát phiên bản ghi lịch sử thay đổi, hỗ trợ làm việc theo nhánh, rà soát và truy vết. Cần quy ước cách đặt tên nhánh, ghi nội dung thay đổi, hợp nhất và đánh dấu bản phát hành. Không lưu mật khẩu hoặc khóa truy cập trong kho mã.
Với bản vẽ và hồ sơ xây dựng, dùng cơ chế quản lý tài liệu phù hợp để kiểm soát mã, lần sửa đổi, trạng thái và phát hành. Lịch sử lưu tệp không tự xác nhận hồ sơ đã được kiểm tra hoặc phê duyệt. Một tệp tên “cuối cùng” hoặc “mới nhất” không đủ để người sử dụng biết nó có hiệu lực hay không.
Tích hợp liên tục cho công cụ tự phát triển
Tích hợp liên tục, thường gọi là CI, là tổ chức việc kiểm tra tự động khi có thay đổi vào mã nguồn. Một luồng cơ bản có thể kiểm tra cấu trúc, quy tắc mã, bài kiểm thử và khả năng tạo bản chạy. Thay đổi không đạt cần được làm rõ trước khi hợp nhất vào nhánh được bảo vệ.
CI không có nghĩa là tự động đưa mọi thay đổi đến người dùng. Phát hành cần có phiên bản xác định, môi trường phù hợp, kết quả kiểm tra, người có quyền cho phép và phương án khôi phục. Công cụ liên quan đến kết quả nghiệp vụ quan trọng cần mức kiểm soát tương xứng.
Tự động hóa từ điểm đau nhỏ
Chọn một việc lặp lại có quy tắc rõ, ví dụ kiểm tra tên tệp hoặc phát hiện thiếu trường trong danh mục. Mô tả đầu vào, đầu ra, ngoại lệ và cách xử lý khi công cụ không chắc chắn. Chạy thử trên bản sao trong phạm vi được phép, so với kết quả đã xác nhận và ghi sai lệch.
Khi công cụ chỉ kiểm tra điều kiện hình thức, kết quả phải ghi đúng là kiểm tra hình thức. Không để một thông báo “đạt” khiến người dùng tưởng đã kiểm đủ nội dung chuyên môn. Phải có người tiếp nhận lỗi, quản lý phiên bản và hướng dẫn người dùng.
Danh mục bàn giao tối thiểu
Một công cụ hoặc kho dữ liệu nên bàn giao được: vị trí lưu; phiên bản; chủ sở hữu công việc; hướng dẫn chạy; dữ liệu cần thiết; quyền truy cập; kiểm tra đã thực hiện; giới hạn; cách sao lưu và khôi phục. Mật khẩu được chuyển qua cơ chế bảo mật được đơn vị cho phép, không ghi thẳng vào hướng dẫn.
Thử một phép kiểm tra thực tế: người tiếp nhận có thể dùng tài liệu để tìm dữ liệu, chạy công việc thông thường và biết phải gọi ai khi có lỗi hay không. Nếu chưa, việc bàn giao còn thiếu dù danh sách tài liệu đã đủ số lượng.
