Mở đầu — vì sao bài này quan trọng
Hãy tưởng tượng bạn là một BA đang viết bản đặc tả nghiệp vụ (BRD) dài 12 trang trong Confluence. Đã 90 phút trôi qua, bạn vừa hoàn thiện phần "Quy tắc nghiệp vụ" với đủ bảng biểu phức tạp. Bỗng nhiên trình duyệt treo cứng, hoặc bạn lỡ tay đóng nhầm tab, hoặc mạng Wi-Fi công ty rớt đúng lúc đó. Nếu là Word lưu cục bộ chưa kịp Ctrl+S, bạn vừa mất toi 90 phút. Đây là cơn ác mộng kinh điển của dân làm tài liệu.
Confluence sinh ra để giải quyết chính xác nỗi đau này. Nhưng nhiều BA dùng Confluence hàng năm trời mà vẫn không hiểu rõ cơ chế draft (bản nháp) hoạt động thế nào, draft được lưu ở đâu, làm sao khôi phục, và quan trọng hơn — khi cả team cùng sửa một trang thì điều gì xảy ra. Hậu quả là họ vẫn giữ thói quen cũ: viết Word ở máy rồi copy-paste vào Confluence, vô tình vứt bỏ toàn bộ sức mạnh cộng tác thời gian thực mà công cụ đem lại.
Bài này tập trung vào hai năng lực cốt lõi mà một BA chuyên nghiệp bắt buộc phải nắm: (1) cơ chế auto-save draft và cách khôi phục khi gặp sự cố, và (2) collaborative editing — chỉnh sửa đồng thời nhiều người trên cùng một trang. Đây không phải kỹ năng "biết cũng được". Khi bạn làm tài liệu phân tích cho dự án thực, bạn sẽ liên tục viết cùng PO, dev lead, QA và stakeholder. Hiểu sai cơ chế này sẽ dẫn đến mất việc đã làm, ghi đè lên nhau, hoặc tệ hơn là publish nhầm bản chưa hoàn thiện cho cả công ty đọc.
Khái niệm cốt lõi
Draft là gì và Confluence lưu nó thế nào
Trong Confluence, mỗi trang có hai trạng thái dữ liệu song song: bản đã publish (mọi người nhìn thấy) và bản draft (nội dung bạn đang gõ dở nhưng chưa nhấn Publish). Khi bạn mở một trang để chỉnh sửa (Edit) hoặc tạo trang mới, Confluence tự động lưu mọi thay đổi của bạn vào draft mỗi vài giây một lần, hoàn toàn ngầm, không cần bạn bấm bất cứ nút nào.
Điều quan trọng cần ghi nhớ: trên Confluence Cloud, draft được lưu trên server chứ không phải chỉ trong bộ nhớ trình duyệt. Nghĩa là nếu máy bạn sập nguồn đột ngột, bạn vẫn có thể mở lại trang đó từ một máy khác và Confluence sẽ hỏi bạn có muốn tiếp tục từ bản nháp gần nhất hay không. Đây là khác biệt căn bản so với Word truyền thống.
Một điểm tinh tế: chỉ khi bạn nhấn nút Publish thì nội dung mới thực sự trở thành phiên bản chính thức và tạo ra một version mới trong lịch sử trang. Trước thời điểm đó, dù bạn gõ bao nhiêu, người khác mở trang vẫn chỉ thấy bản publish cũ. Draft của bạn là "riêng tư" theo nghĩa nó chưa được công bố — dù về mặt kỹ thuật người có quyền vẫn có thể thấy có người đang sửa trang.
Tìm lại draft bị mất qua "Recently worked on" và Drafts
Khi tab bị đóng đột ngột giữa chừng, có ba con đường để khôi phục. Thứ nhất, mở lại đúng trang đó và nhấn Edit — Confluence thường hiển thị thông báo "There are unpublished changes" (có thay đổi chưa publish) và cho bạn lựa chọn tiếp tục. Thứ hai, vào mục Recent trên thanh điều hướng, ở đó có tab các trang bạn vừa làm việc, bao gồm cả những draft chưa publish. Thứ ba, với trang mới hoàn toàn (chưa từng publish lần nào), bạn tìm trong phần hồ sơ cá nhân, mục liệt kê các draft đang treo. Lưu ý rằng giao diện Confluence Cloud được Atlassian cập nhật khá thường xuyên, nên vị trí chính xác của menu có thể đổi, nhưng logic "draft luôn được giữ lại ở đâu đó" thì không đổi.
Collaborative editing — nhiều người cùng sửa một lúc
Đây là viên ngọc của Confluence hiện đại. Nhiều người có thể mở cùng một trang ở chế độ Edit và gõ đồng thời, giống hệt Google Docs. Bạn sẽ thấy con trỏ màu của từng người, kèm avatar và tên hiển thị ở góc trên. Khi đồng nghiệp gõ, chữ của họ hiện ra ngay trên màn hình bạn theo thời gian thực, không cần refresh.
Cơ chế kỹ thuật phía sau gọi là operational transformation — Confluence hợp nhất từng thao tác gõ phím của mỗi người một cách thông minh để không ai ghi đè lên ai. Hai người gõ ở hai đoạn khác nhau thì hoàn toàn độc lập. Ngay cả khi hai người sửa cùng một câu, hệ thống vẫn cố gắng hòa trộn thay vì bắt một người thua cuộc.
Điểm cực kỳ quan trọng với cộng tác: chỉ cần một người nhấn Publish là toàn bộ thay đổi của tất cả mọi người trong phiên đó được publish chung thành một version. Bạn không cần ai cũng phải bấm Publish riêng. Điều này vừa tiện vừa nguy hiểm — ai đó vô tình Publish khi cả nhóm còn đang viết dở thì bản chưa hoàn thiện sẽ lộ ra ngay.
Tình huống thực tế
Tình huống 1 — Mất 2 giờ làm việc tưởng như đã bay (công ty fintech ở TP.HCM)
Chị Lan là Senior BA tại một công ty fintech khoảng 120 nhân sự ở Quận 1, TP.HCM. Chị đang soạn tài liệu phân tích cho tính năng "Thanh toán hóa đơn điện nước" — một trang dài với 4 sơ đồ luồng và bảng quy tắc validation 30 dòng. Sau 2 tiếng tập trung, laptop của chị tự khởi động lại để cài bản cập nhật Windows mà chị quên hoãn.
Phản xạ đầu tiên của chị Lan là hoảng loạn, vì trước đây ở công ty cũ dùng Word chung trên ổ mạng, mất là mất luôn. Nhưng team lead nhắc chị mở lại Confluence. Khi chị truy cập đúng trang và bấm Edit, Confluence hiện dòng "There are unpublished changes from your last session" và toàn bộ nội dung 2 tiếng vẫn còn nguyên — kể cả 4 sơ đồ. Chỉ mất khoảng 90 giây cuối cùng (đoạn chị gõ ngay trước khi máy restart) là chưa kịp lưu.
Bài học: Auto-save draft trên Confluence Cloud lưu ở server, nên sự cố phần cứng gần như không thể xóa sạch công sức của bạn. Nhưng "gần như" không phải "tuyệt đối" — vẫn có vài giây cuối cùng có thể mất. Với những đoạn cực kỳ quan trọng, thỉnh thoảng nhấn Publish để chốt một mốc an toàn vẫn là thói quen đáng giá.
Tình huống 2 — Cộng tác thời gian thực trong buổi workshop (startup logistics, Singapore–Việt Nam)
Một startup logistics có đội phát triển trải dài Singapore và Đà Nẵng đang chạy buổi workshop online để hoàn thiện đặc tả API tích hợp đối tác giao hàng. Trên một cuộc gọi Google Meet, BA tên Minh chia sẻ màn hình Confluence ở chế độ Edit. Thay vì Minh tự gõ tất cả còn mọi người đọc, anh mời cả PO, tech lead và một QA cùng mở trang đó và sửa trực tiếp.
Kết quả: trong 45 phút, tech lead ngồi điền các trường JSON mẫu vào bảng request/response, QA bổ sung cột "Trường hợp lỗi cần test", còn Minh tập trung mô tả luồng nghiệp vụ. Mỗi người thấy con trỏ màu của nhau di chuyển, biết ai đang sửa chỗ nào nên không giẫm chân lên nhau. Cuối buổi, Minh nhấn Publish một lần, và toàn bộ đóng góp của bốn người gộp thành một version duy nhất với ghi chú "Workshop API spec v1".
Bài học: Collaborative editing biến Confluence thành "bàn họp ảo". Tài liệu hoàn thiện ngay trong buổi họp thay vì để một người về nhà gõ lại từ ghi chú rời rạc. Mẹo phối hợp: thống nhất trước "ai phụ trách phần nào" để tận dụng được tính song song mà không lộn xộn.
Tình huống 3 — Tai nạn Publish sớm (agency phần mềm ở Hà Nội)
Tại một software agency ở Cầu Giấy, Hà Nội, bạn BA tên Trang và một đồng nghiệp đang cùng nháp bản BRD cho khách hàng. Trang mới viết phần mở đầu, còn rất nhiều mục để trống và vài dòng ghi chú nội bộ kiểu "TODO: hỏi lại khách về SLA". Đồng nghiệp của Trang, do quen tay, bấm Publish để "lưu lại cho chắc". Vấn đề: trang này đã được set thông báo tự động cho cả space, nên ngay khi Publish, một email "Page updated" bắn tới cả Project Manager phía khách hàng.
Khách hàng mở ra đọc, thấy bản nham nhở đầy chỗ trống và dòng ghi chú nội bộ, liền nhắn hỏi "Sao tài liệu trông chưa xong mà đã gửi?". Trang phải giải thích và xin lỗi, đồng thời dùng tính năng lịch sử để hiểu chuyện gì đã xảy ra.
Bài học: Trong phiên cộng tác, chỉ một cú Publish là công bố cho tất cả. Hãy phân biệt rõ giữa "đang nháp" (cứ để draft, không Publish) và "đã sẵn sàng công bố". Với tài liệu nhạy cảm, nên thống nhất quy ước: chỉ người chủ trì mới được Publish, và chỉ Publish khi đã rà soát xong. Ngoài ra, hạn chế viết ghi chú nội bộ thẳng vào nội dung trang — nếu cần thì dùng inline comment để ghi chú riêng.
Hướng dẫn từng bước
Bước 1 — Bắt đầu một trang và quan sát auto-save. Tạo trang mới hoặc Edit trang có sẵn. Gõ vài dòng rồi để ý góc trên (gần nút Publish). Confluence hiển thị trạng thái lưu, thường là dòng chữ nhỏ cho biết các thay đổi đã được lưu tự động. Bạn không cần làm gì — chỉ cần biết nó đang chạy ngầm.
Bước 2 — Mô phỏng sự cố để kiểm tra khôi phục. Khi đang sửa dở, cố tình đóng tab (đừng Publish). Mở lại Confluence, vào đúng trang đó, nhấn Edit. Quan sát thông báo về "unpublished changes" và xác nhận nội dung vẫn còn. Làm thử một lần để bạn yên tâm trong những lúc thật sự khẩn cấp.
Bước 3 — Tìm danh sách draft. Vào mục Recent trên thanh điều hướng để xem các trang vừa làm việc. Với draft của trang mới chưa từng publish, kiểm tra thêm trong khu vực hồ sơ/profile của bạn nơi liệt kê các bản nháp đang treo. Học cách điều hướng tới đây để không bao giờ "lạc mất" một draft.
Bước 4 — Mời người khác cùng sửa. Gửi link trang ở chế độ Edit (hoặc share trang) cho đồng nghiệp. Khi họ vào, bạn sẽ thấy avatar của họ xuất hiện ở góc trên và con trỏ màu của họ trong nội dung. Thử mỗi người gõ ở một đoạn khác nhau để cảm nhận tính đồng thời.
Bước 5 — Thống nhất quy ước Publish. Trước khi cộng tác, cả nhóm thống nhất ai là người nhấn Publish và khi nào. Quy ước đơn giản như "chỉ chủ trì Publish, và chỉ Publish khi đã xóa hết TODO" giúp tránh tai nạn như Tình huống 3.
Bước 6 — Publish và kiểm tra version. Khi đã sẵn sàng, nhấn Publish. Vào lịch sử trang (Page History) để xác nhận một version mới được tạo, ghi nhận đóng góp của phiên cộng tác. Đây là mốc an toàn — từ đây nếu cần bạn luôn có thể quay lại.
Lỗi thường gặp & mẹo
Lỗi 1 — Tưởng "không bấm Publish là mất hết". Nhiều BA mới hoảng khi đóng tab vì nghĩ chưa lưu. Thực tế draft vẫn còn. Đừng vội tạo lại trang mới — hãy mở lại đúng trang cũ và bấm Edit trước.
Lỗi 2 — Tạo trùng trang vì không thấy draft. Khi không tìm thấy bản nháp ngay, người dùng tạo trang mới và bắt đầu lại, dẫn đến hai trang trùng nội dung. Mẹo: luôn kiểm tra mục Recent và danh sách draft trong profile trước khi tạo mới.
Lỗi 3 — Publish trong khi đồng đội đang viết dở. Như đã thấy ở Tình huống 3, một cú Publish công bố mọi thứ. Mẹo: trong phiên cộng tác, hãy hỏi "mọi người xong chưa?" trên kênh chat trước khi Publish.
Lỗi 4 — Viết ghi chú nội bộ thẳng vào nội dung. Những dòng "TODO", "hỏi lại sếp", "chỗ này chưa chắc" nếu nằm trong thân trang sẽ bị publish ra. Mẹo: dùng inline comment để ghi chú riêng, hoặc một macro panel cảnh báo rõ ràng, và xóa sạch trước khi công bố.
Lỗi 5 — Lạm dụng copy-paste từ Word. Dán nội dung từ Word vào Confluence thường kéo theo định dạng rác và làm hỏng bảng. Mẹo: viết trực tiếp trong Confluence để tận dụng auto-save và cộng tác; nếu buộc phải dán, dùng "Paste as plain text".
Mẹo phối hợp nhóm: Trước buổi cộng tác, chia rõ "ai làm phần nào" để tận dụng tính song song. Khi nhiều người cùng sửa một bảng lớn, hãy mỗi người một hàng/cột để giảm xung đột thị giác. Và đừng ngại để con trỏ của bạn cho người khác thấy — đó chính là tín hiệu giúp cả nhóm tránh giẫm chân nhau.
Mẹo an toàn cá nhân: Với những đoạn dài và quan trọng, cứ vài chục phút hãy Publish một lần để chốt mốc. Bạn vẫn có thể tiếp tục Edit sau đó. Mỗi lần Publish là một điểm khôi phục chắc chắn trong lịch sử trang.
Bài tập thực hành
- Kiểm tra auto-save: Tạo một trang nháp tên "Lab 41 — Draft test", gõ khoảng 5 dòng, không nhấn Publish, rồi đóng hẳn tab. Mở lại Confluence, tìm và khôi phục lại bản nháp này. Ghi lại bạn đã tìm thấy nó ở đâu (Recent hay profile).
- Mô phỏng cộng tác: Rủ một đồng nghiệp (hoặc tự mở thêm một trình duyệt khác đăng nhập tài khoản khác) cùng Edit một trang. Mỗi người gõ ở một đoạn. Quan sát con trỏ màu và avatar. Sau đó để một người nhấn Publish và kiểm tra trong Page History xem version mới ghi nhận thế nào.
- Tránh tai nạn Publish: Soạn một trang có chứa 3 dòng ghi chú nội bộ kiểu "TODO". Thay vì để chúng trong thân trang, hãy chuyển chúng thành inline comment. Sau đó Publish và xác nhận người đọc bản công bố không nhìn thấy các ghi chú đó.
- Suy ngẫm: Viết ngắn gọn (3–4 câu) một quy ước Publish mà team bạn nên áp dụng để tránh tình huống publish sớm như ví dụ ở Hà Nội. Lưu chính nó thành một trang Confluence để luyện tay.
Tóm tắt
Confluence tự động lưu mọi thứ bạn gõ vào draft sau mỗi vài giây, và trên bản Cloud, draft nằm trên server nên sự cố máy móc gần như không xóa được công sức của bạn — bạn khôi phục bằng cách mở lại trang và bấm Edit, hoặc tìm trong Recent và danh sách draft ở profile. Quan trọng nhất: nội dung chỉ thực sự công bố khi có người nhấn Publish, và mỗi lần Publish tạo một version mới làm điểm khôi phục.
Về collaborative editing, nhiều người có thể cùng sửa một trang theo thời gian thực với con trỏ màu riêng, hệ thống tự hòa trộn các thao tác để không ai ghi đè ai. Nhưng hãy nhớ: chỉ một cú Publish là công bố cho tất cả, nên cần thống nhất quy ước "ai Publish và khi nào", tách ghi chú nội bộ ra khỏi thân trang, và phân chia phần việc rõ ràng để tận dụng sức mạnh song song. Nắm vững hai cơ chế này, bạn sẽ làm tài liệu BA nhanh hơn, an toàn hơn, và cộng tác mượt mà hơn hẳn cách viết Word truyền thống.