Architecture Decision Record

Active theme: Light

← tài-liệu

Lời khuyên làm việc nhóm cho ADR

Nếu bạn đang cân nhắc sử dụng các bản ghi quyết định với nhóm của mình, đây là một số lời khuyên mà chúng tôi đã học được khi làm việc với nhiều nhóm.

Bạn có cơ hội dẫn dắt đồng đội bằng cách cùng nhau trao đổi về "tại sao", thay vì áp đặt "cái gì". Ví dụ, các bản ghi quyết định là một cách để các nhóm suy nghĩ thông minh hơn và giao tiếp tốt hơn; các bản ghi quyết định không có giá trị nếu chúng chỉ là một yêu cầu giấy tờ bị ép buộc sau sự việc.

Một số nhóm thích tên "decisions" (quyết định) hơn nhiều so với từ viết tắt "ADR". Khi một số nhóm dùng tên thư mục "decisions", dường như một bóng đèn bật sáng, và nhóm bắt đầu đưa nhiều thông tin hơn vào thư mục đó, chẳng hạn quyết định về nhà cung cấp, quyết định về kế hoạch, quyết định về lịch trình, v.v. Tất cả các loại thông tin này đều có thể dùng cùng một mẫu. Chúng tôi đưa ra giả thuyết rằng mọi người học nhanh hơn với từ ngữ ("quyết định") so với từ viết tắt ("ADR"), và mọi người có động lực viết các tài liệu đang thực hiện hơn khi bỏ từ "bản ghi", và cũng có một số nhà phát triển và một số quản lý không thích từ "kiến trúc".

Về lý thuyết, tính bất biến là lý tưởng. Trong thực tế, tính khả biến đã hiệu quả hơn với các nhóm của chúng tôi. Chúng tôi chèn thông tin mới vào ADR hiện có, kèm dấu ngày tháng, và một ghi chú rằng thông tin đến sau quyết định. Cách tiếp cận này dẫn đến một "tài liệu sống" mà tất cả chúng tôi đều có thể cập nhật. Các cập nhật điển hình là khi chúng tôi có được thông tin nhờ đồng đội mới, hoặc các dịch vụ mới, hoặc kết quả thực tế từ việc sử dụng của chúng tôi, hoặc sau những thay đổi của bên thứ ba sau sự việc như khả năng của nhà cung cấp, gói giá, thỏa thuận cấp phép, v.v.