Nhận xét về các dụng cụ.
Chúng tôi đã thử wiki trực tuyến nhưng tìm thấy một số hạn chế, có thể là sở thích cá nhân, nhưng bao gồm cấu trúc tài liệu và hầu hết phải được kết nối với máy chủ tài liệu.
Đang kết nối là một vấn đề nghiêm trọng nếu bạn ở chế độ ngoại tuyến hoặc tại chỗ (rõ ràng bạn có thể giảm thiểu tại chỗ bằng kết nối SSL được bảo mật và các cộng sự).
Quy trình tài liệu hiện tại của chúng tôi là:
- trình tạo html tĩnh
- cú pháp đánh dấu
- hệ thống phiên bản phân tán
Chúng tôi có bố cục 'trang trọng' cho tài liệu và cung cấp cấu trúc cho các menu (và CSS được liên kết để tạo kiểu trực quan, v.v.)
Trình tạo HTML tĩnh
Chúng tôi sử dụng một trình tạo html tĩnh trong nhà dựa trên cubictemp và một số công cụ khác: pygments , docutils .
Các trang được tạo ra trông có vẻ xấu xí, vì hầu hết chúng ta / các hệ thống / lập trình viên của chúng ta đều biết cái gì là đẹp về mặt thẩm mỹ nhưng lại thiếu sự phối hợp để xây dựng như vậy.
Nhưng nó có / cho chúng tôi bao gồm các tệp cấu hình, tập lệnh mẫu, pdf, v.v., mà không phải lo lắng về định dạng html làm hỏng nó hoặc lo lắng về nơi tìm thấy nó trên 'máy chủ' để tải xuống.
Nếu nó không phải là HTML, chỉ cần thả nó vào thư mục và thêm một liên kết url vào nó.
HTML cung cấp cấu trúc 'tiềm năng' để bố trí và cũng cung cấp chính xác 'liên kết' giữa các mục kiến thức / nội dung (cũng như các cơ chế cấu trúc cơ sở, chẳng hạn như có thể tạo menu, bảng nội dung, v.v.) Với HTML, giờ đây mỗi người dùng có thể chạy một máy chủ web nhỏ trên máy của họ cho dù lighttpd hoặc một cái gì đó nhỏ hoặc chỉ phát triển đầy đủ với Apache hoặc IIS.
Tất cả các máy của chúng tôi đều có khả năng phục vụ html cơ bản và hoạt động đủ tốt cho chúng tôi.
Cú pháp đánh dấu.
Chúng tôi sử dụng một phiên bản bastardised của MARKDOWN, Textish và hoặc tái cấu trúcTEXT để cho các loại nước ép 'sáng tạo' của chúng tôi viết tài liệu mà không phải lo lắng về HTML.
Điều đó cũng có nghĩa là mọi người đều được sử dụng trình soạn thảo yêu thích của họ (tôi sử dụng Scintilla trên Windows và * Nix) trong khi những người khác ở đây sử dụng vi / vim.
Hệ thống phiên bản phân tán.
Chúng tôi sử dụng Git để 'phân phối' tài liệu giữa những người dùng. Ồ, và chúng tôi cũng sử dụng khả năng phiên bản của nó.
Lợi thế chính cho chúng tôi là tất cả chúng tôi đều có thể cập nhật tài liệu mà không cần phải kết nối với máy chủ và không phải xuất bản các tác phẩm 'đã hoàn thành'. Tất cả chúng ta có thể làm việc trên cùng một phần của tài liệu, hoặc các phần khác nhau, hoặc chỉ tiêu thụ thông tin.
Cá nhân, tôi ghét bị ràng buộc với một máy chủ để cập nhật blog chứ đừng nói đến wiki. Git hoạt động tốt cho chúng tôi.
Nhận xét về quy trình làm việc
Wiki dường như là "mốt" để phổ biến / mã hóa kiến thức, nhưng như đã nhận xét ở mọi nơi, mọi quy trình trở nên khó duy trì và việc tìm ra hỗn hợp các công cụ hỗ trợ tốt nhất cho các nhóm của bạn và sẽ bền vững.
Các giải pháp tốt hơn cuối cùng chỉ được phát hiện và không bắt buộc.