Mọi người đều biết rằng phát triển phần mềm được ghi chép tốt dẫn đến thành công. Tuy nhiên, điều đó thường có nghĩa là không chỉ văn bản thuần túy mà cả nội dung nhị phân cũng sẽ được tham gia vào tài liệu, chẳng hạn như sơ đồ UML. Và tôi đã nghe nhiều người nói vậy. Hệ thống kiểm soát phiên bản không phải là nơi thích hợp cho các tệp nhị phân. Tôi hoàn toàn hiểu và đồng ý với vấn đề này. Tôi đã hỏi một số nhà phát triển dày dạn về nơi lưu trữ tài liệu tốt nhất và câu trả lời tôi nhận được là "wiki". Wiki là tốt nhưng tôi đã xem xét một vấn đề tiềm năng khác. Làm thế nào mã nguồn được lưu trữ trong hệ thống kiểm soát phiên bản có thể kết nối với tài liệu liên quan của nó trong wiki? Giả sử ai đó nhân bản kho lưu trữ của git hoặc đồng bóng. Làm thế nào anh ấy / cô ấy có thể tìm thấy tài liệu dễ dàng? Hay tôi vừa bỏ lỡ điều gì?
Tôi biết một số hệ thống wiki có khả năng tích hợp với các hệ thống kiểm soát nguồn. Nhưng mối quan tâm của tôi không phải là về khả năng hội nhập. Nếu bạn đã sao chép mã nguồn từ kho git và sau một thời gian bạn lên tàu và muốn tiếp tục làm việc ngoại tuyến trên tàu (đó là một tính năng lớn của DVCS). Sau đó, bạn đột nhiên nhận ra rằng bạn không có quyền truy cập vào tài liệu vì bạn đang làm việc ngoại tuyến trên tàu. Mặt khác, nếu tài liệu được lưu trữ trong kho git, bạn sẽ có quyền truy cập vào tài liệu với kho lưu trữ được nhân bản.