Tôi đã tìm thấy BẤT K document tài liệu nào tốt hơn tài liệu KHÔNG. Số tiền thích hợp thường được xác định theo thời gian chúng tôi phải thực hiện hoặc bằng cách chúng tôi ghét các cuộc gọi điện thoại và email hỗ trợ.
Dường như các thành viên trong nhóm hiện tại của bạn có một số kỳ vọng không thực tế về ký ức của họ, hoặc họ xấu hổ về kỹ năng viết của họ và không sẵn sàng thực hành.
Tôi nhận ra mình thuộc một nhóm thiểu số (chuyên ngành tiếng Anh, người đã theo học ngành kỹ thuật phần mềm ở trường đại học) ở đây, vì tôi không tìm thấy tài liệu như một việc vặt. Đó là một công cụ chuyên nghiệp có giá trị. Tôi có thể không thấy viết khó như một số đồng nghiệp của mình, nhưng điều đó chủ yếu là vì tôi đã thực hành nhiều hơn về nó. Tôi không xem xét một dự án đã hoàn thành trừ khi nó có tài liệu và tôi thường viết nó vì những lý do hoàn toàn ích kỷ: vì vậy tôi có thể đưa cho mọi người thứ gì đó để đọc thay vì gọi điện thoại và email, hoặc vì vậy tôi có thể nhớ những gì chúng ta đã nói về lần trước tháng, hoặc vì vậy tôi có thể tham khảo cách tôi đã làm một cái gì đó nếu tôi cần hỗ trợ nó vào giữa đêm.
Cách tốt nhất để tiếp cận tài liệu là viết nó NHƯ BẠN ĐI, chính xác như viết mã kiểm tra. Thật đáng ngạc nhiên khi một vài mẫu được viết sẵn (với các tiêu đề, sơ khai mã, v.v.) có thể làm cho tài liệu dễ dàng hơn và nhanh hơn để làm. Bằng cách này, bạn có thể nắm bắt được sự thay đổi khi nó xảy ra và bạn có ít mặt bằng hơn để che đậy theo thời gian. Bạn hiệu quả hơn theo cách này, vì bạn có thể tham khảo tài liệu khi bạn cần và bạn thay đổi nó trên đường đi. Ví dụ, làm như vậy trong wiki giúp cập nhật dễ dàng hơn và bạn có thể tránh các sự cố phiên bản tài liệu nếu bản mới nhất và lớn nhất luôn trực tuyến ở cùng một nơi và bạn chỉ có thể gửi liên kết tới những người cần đọc nó.
Nếu bạn dành một ít thời gian để làm tài liệu, bạn sẽ TẤT CẢ làm việc nhanh hơn, đặc biệt là khi ai đó mới gia nhập nhóm, vì họ sẽ không phải dành tất cả thời gian đó để tìm ra mọi thứ. Tìm hiểu công cụ là một phần thú vị trong công việc của chúng tôi, nhưng thật không vui khi bạn phải vội vàng sửa chữa sản xuất. Tất cả chúng ta sẽ tiết kiệm rất nhiều thời gian nếu tất cả chúng ta đã viết thêm một vài ghi chú.
Nhóm của bạn có cùng các vấn đề với kiểm tra hoặc viết mã kiểm tra không? Nếu không, đây sẽ là một bán dễ dàng hơn.
Tài liệu của bạn hữu ích theo nhiều cách:
1) Đối với bạn, ngay bây giờ và với đồng nghiệp, khi bạn làm việc trong dự án.
2) Để khách hàng của bạn. Có tài liệu (bao gồm các sơ đồ) mà bạn có thể hiển thị cho người dùng giúp cho các cuộc thảo luận trong các cuộc họp dễ dàng hơn, đặc biệt nếu bạn đang thảo luận về các hệ thống phức tạp. Ngay cả khi tài liệu không đầy đủ, đó là nơi để bắt đầu.
3) Gửi đến những người sẽ kế thừa công việc của bạn (thậm chí có thể là bạn, trong ba năm). Nhiều đồng nghiệp trẻ của tôi nghĩ rằng họ sẽ nhớ mọi thứ mãi mãi. Tôi biết tôi sẽ không nhớ nó trong tuần này nếu tôi không viết nó ra. Có tài liệu giúp bạn không phải mất nửa ngày để nhớ cách bạn cấu trúc một cái gì đó, và phải tìm lại tất cả.
4) Đối với bạn và những người khác, nếu tình hình trở nên chính trị hoặc gây tranh cãi. Là một người ghi chép trong các cuộc họp, để giữ cho mình tỉnh táo và chống lại sự nhàm chán, tôi thường là người duy nhất có phiên bản bằng văn bản của một quyết định. Người viết nó xuống thắng cuộc tranh chấp. Hãy nhớ điều này vào lần tới khi ai đó nói rằng "Hãy nhớ rằng cuộc họp mà chúng ta đã có trong mùa đông vừa qua tại phòng hội nghị 4, khi chúng ta đi qua X? Fred đã ở đó, và anh chàng đó từ Kế toán là ai?"