Bài hướng dẫn từng bước tốt là bài mà một người chưa biết gì có thể làm theo từ đầu đến cuối mà không phải đoán ở bước nào. Nghe đơn giản, nhưng người viết hiểu việc quá rõ nên thường bỏ qua những bước mà với họ là hiển nhiên. Chính những bước đó khiến người đọc mắc kẹt và bỏ bài giữa chừng.
Bài này dành cho người viết blog hướng dẫn về bất kỳ việc gì: nấu một món, cài một phần mềm, làm một thủ tục, sửa một món đồ đơn giản. Bạn sẽ có cấu trúc một bài hướng dẫn, cách chia bước và viết câu cho từng bước, cách báo trước chỗ dễ sai, cách dùng AI tìm lỗ hổng trong hướng dẫn, và quan trọng nhất là cách thử lại bằng một người thật.
Lời nguyền của người biết: vì sao người giỏi hay viết hướng dẫn khó hiểu
Khi bạn đã làm một việc hàng trăm lần, nhiều thao tác trở thành phản xạ. Bạn không còn nghĩ đến việc phải tắt nguồn trước khi tháo nắp, phải bấm lưu trước khi đóng cửa sổ, phải ngâm gạo trước khi nấu. Viết hướng dẫn từ trí nhớ, những bước đó biến mất mà bạn không hề nhận ra. Người đọc mới thì không có phản xạ đó, nên họ làm đúng như bạn viết, và hỏng.
Hiện tượng này đã được bàn nhiều trong tâm lý học và giáo dục dưới tên gọi lời nguyền của tri thức: một khi đã biết, rất khó tưởng tượng lại cảm giác chưa biết. Không có cách nào tự thoát hoàn toàn, nhưng có ba cách giảm bớt. Viết hướng dẫn trong lúc đang làm thật, không viết từ trí nhớ. Nhờ một người khác làm theo bản nháp. Và dùng AI đóng vai người mới hoàn toàn để soi những chỗ bạn nhảy bước.
Cách thứ ba rẻ và nhanh, nhưng không thay được hai cách đầu. AI không thật sự cầm tua vít hay đứng trước bếp; nó chỉ đoán những chỗ người mới có thể vấp dựa trên ngôn ngữ. Nó phát hiện tốt các bước thiếu về mặt logic, nhưng không phát hiện được rằng con ốc ở bước năm thực ra nằm ở mặt sau, hay nút bạn nhắc tới đã đổi tên ở phiên bản mới.
Cấu trúc một bài hướng dẫn hoàn chỉnh
Bài hướng dẫn dài thường cần đủ các phần dưới đây. Không phải bài nào cũng cần tất cả, nhưng thiếu phần nào thì nên có lý do.
- Kết quả cuối cùng: mô tả ngắn người đọc sẽ có gì khi làm xong, để họ biết mình đang đi đến đâu.
- Ai nên đọc và ai không: trình độ cần có, điều kiện áp dụng. Một câu "bài này dành cho máy chạy hệ điều hành bản cũ" tiết kiệm cho người đọc hàng chục phút.
- Chuẩn bị: danh sách dụng cụ, nguyên liệu, tài khoản, thời gian ước tính. Người đọc cần biết trước khi bắt đầu, không phải phát hiện giữa chừng.
- Các bước: đánh số, mỗi bước một hành động chính, có dấu hiệu nhận biết đã làm đúng.
- Chỗ dễ sai: đặt ngay tại bước liên quan, không dồn hết xuống cuối bài.
- Kiểm tra kết quả: cách biết mình đã làm xong và làm đúng.
- Khi không như mong đợi: vài tình huống hỏng hay gặp và cách xử lý, hoặc khi nào nên dừng và nhờ người có chuyên môn.
Phần chuẩn bị thường bị xem nhẹ vì người viết coi nó là danh sách khô khan. Thực ra đây là phần người đọc quay lại nhiều nhất, đặc biệt khi họ đọc bài trên điện thoại trong lúc đi mua đồ. Viết rõ tên, số lượng, và nếu có thể thì cách thay thế khi không tìm được thứ đó.
Viết từng bước sao cho làm theo được ngay
Mỗi bước bắt đầu bằng động từ. Viết "Mở nắp hộp mực ở mặt trước máy in" thay vì "Bước này bạn sẽ cần mở nắp". Động từ đứng đầu giúp người đọc biết ngay phải làm gì, nhất là khi họ vừa nhìn hướng dẫn vừa thao tác.
Một bước, một hành động chính. Nếu một bước có ba việc nối bằng chữ "rồi", hãy tách thành ba bước. Bước quá dài khiến người đọc làm xong việc đầu, quay lại đọc, rồi không biết mình đang ở đâu.
Nói vị trí trước, hành động sau. "Ở góc phải phía trên màn hình, bấm vào biểu tượng ba chấm" dễ làm theo hơn "Bấm vào biểu tượng ba chấm ở góc phải phía trên màn hình", vì mắt người đọc tìm vị trí trước rồi mới tìm biểu tượng.
Cho dấu hiệu đã làm đúng. Sau các bước quan trọng, thêm một câu như "đèn chuyển sang màu xanh" hay "nước bắt đầu sôi lăn tăn ở mép nồi". Dấu hiệu này cho người đọc tự tin đi tiếp hoặc biết mình cần quay lại.
Ghi lý do khi bước có vẻ thừa. Người đọc hay bỏ qua những bước họ thấy không cần, như rửa sạch dụng cụ hay chờ mười phút. Một câu ngắn giải thích vì sao sẽ giữ họ làm đủ.
Dùng đúng một tên cho một thứ. Đã gọi là "nút lưu" thì đừng chỗ khác gọi là "biểu tượng đĩa mềm". Người đọc mới sẽ nghĩ đó là hai thứ khác nhau.
Dùng AI tìm lỗ hổng trong bản hướng dẫn
Sau khi có bản nháp, AI có thể đóng vai người đọc mới để soi chỗ thiếu. Các bước làm:
- Dán bản nháp vào AI, kèm mô tả người đọc mục tiêu. Câu lệnh gợi ý: "Bạn là người chưa từng làm việc này, chỉ có những dụng cụ ghi trong phần chuẩn bị. Đọc từng bước và dừng lại ở bất kỳ chỗ nào bạn không biết phải làm gì, không biết thứ được nhắc đến nằm ở đâu, hoặc không biết đã làm đúng chưa. Liệt kê các chỗ đó theo số bước."
- Đọc danh sách máy trả về và phân loại: chỗ thiếu thật, chỗ máy thắc mắc vì không nhìn thấy đồ vật, và chỗ máy hỏi thừa.
- Sửa những chỗ thiếu thật. Với chỗ máy không nhìn thấy, tự hỏi người mới có nhìn thấy không; nếu có thể nhầm, thêm mô tả vị trí hoặc ảnh chụp.
- Yêu cầu máy liệt kê năm cách người đọc có thể làm sai ở bước khó nhất. Chọn những cách sai có thật để đưa vào phần chỗ dễ sai.
- Không nhờ máy viết lại các bước bằng giọng của nó. Bước hướng dẫn cần đúng với thao tác thật bạn đã làm, máy có thể vô tình đổi thứ tự hoặc thêm bước không tồn tại.
Nếu hướng dẫn liên quan đến phần mềm, tài khoản hay thủ tục, đừng dán ảnh chụp màn hình có tên đăng nhập, số tài khoản, mã khách hàng hay thông tin cá nhân của ai vào AI. Che những phần đó trước, và nhớ rằng tên nút, vị trí menu thay đổi theo phiên bản; ghi rõ bài viết theo phiên bản nào và thời điểm nào.
Thử lại bằng một người thật trước khi đăng
Không phép kiểm nào tốt bằng việc nhờ một người chưa biết làm theo bản nháp trong khi bạn ngồi cạnh và không nói gì. Người đó có thể là người nhà, đồng nghiệp, một người bạn ở lĩnh vực khác. Việc của bạn là quan sát và ghi lại: họ dừng ở đâu, đọc lại câu nào hai lần, làm khác với bạn tưởng ở chỗ nào. Bạn không được giải thích, vì khi đăng lên bạn cũng không ngồi cạnh được người đọc nào.
Thường chỉ một lần thử là đủ phát hiện ba đến năm chỗ cần sửa. Có chỗ là bước thiếu, có chỗ là từ người đọc không hiểu, có chỗ là thứ tự gây nhầm. Với những hướng dẫn có rủi ro, như dùng dụng cụ sắc, nhiệt, điện hay hoá chất gia dụng, việc thử lại càng quan trọng, và bài nên ghi rõ những việc người đọc không nên tự làm.
Nếu không có ai để thử, cách thay thế kém hơn nhưng vẫn có ích là tự làm lại theo đúng chữ trong bài sau vài ngày, khi trí nhớ về thao tác đã phai bớt. Đọc từng câu, làm đúng từng câu, không làm theo thói quen. Bạn sẽ ngạc nhiên vì số chỗ chính mình cũng phải đoán.
Bảng soát bài hướng dẫn trước khi đăng
Bảng dưới gom các điểm hay sót, chia theo phần của bài. Đánh dấu từng dòng khi đã kiểm.
| Phần | Cần kiểm | Dấu hiệu chưa đạt |
|---|---|---|
| Đầu bài | Kết quả cuối, người đọc phù hợp, thời gian ước tính | Người đọc phải đọc đến bước ba mới biết bài có hợp với mình không |
| Chuẩn bị | Đủ tên, số lượng, cách thay thế | Một dụng cụ chỉ xuất hiện lần đầu ở giữa các bước |
| Các bước | Động từ đầu câu, một hành động mỗi bước, dấu hiệu làm đúng | Bước dài nhiều dòng, nối bằng chữ rồi, sau đó |
| Chỗ dễ sai | Nằm cạnh bước liên quan | Toàn bộ cảnh báo dồn ở cuối bài |
| Phiên bản | Ghi rõ phiên bản, thời điểm viết | Tên nút, vị trí menu không còn khớp với bản hiện hành |
| An toàn | Việc không nên tự làm, khi nào nhờ người có chuyên môn | Bài khuyến khích tự làm phần có rủi ro mà không cảnh báo |
Bài hướng dẫn cũng cần được cập nhật. Đặt lịch xem lại sau vài tháng, nhất là bài về phần mềm và thủ tục, vì đó là loại thay đổi nhanh nhất. Ghi ngày cập nhật ở đầu bài để người đọc biết thông tin còn mới hay không.
Câu chữ cụ thể: đơn vị, thời gian và từ chuyên môn
Người đọc bài hướng dẫn làm đúng những gì chữ nói, nên chữ phải đo được. "Cho một ít muối" hay "để một lúc" là chỗ người mới phải đoán. Ghi rõ đơn vị mà người đọc có sẵn trong tay: thìa cà phê, ngón tay, vạch trên bình, số phút trên đồng hồ. Khi thời gian thay đổi theo điều kiện, ghi khoảng và dấu hiệu nhận biết: "khoảng tám đến mười hai phút, đến khi mép bánh chuyển vàng". Dấu hiệu đáng tin hơn con số, vì bếp mỗi nhà một khác.
Từ chuyên môn là chỗ thứ hai cần chú ý. Bạn có thể dùng, vì người đọc cần biết tên đúng để tìm thêm thông tin, nhưng lần đầu xuất hiện phải giải thích ngắn trong ngoặc hoặc bằng một câu. Sau đó dùng nhất quán một tên. Nếu người đọc của bạn ở nhiều vùng, để ý từ địa phương: cùng một dụng cụ có thể mang tên khác nhau ở miền Bắc và miền Nam, ghi cả hai tên giúp không ai lạc.
AI giúp tốt ở khâu này. Dán bản nháp và yêu cầu: "Liệt kê mọi chỗ trong bài dùng lượng, thời gian, mức độ không đo được, như một ít, vừa đủ, một lúc, nhỏ lửa, và mọi từ chuyên môn chưa được giải thích." Máy sẽ quét nhanh hơn mắt người. Nhưng con số thay thế thì bạn phải điền từ thao tác thật, không lấy con số máy gợi ý.
Câu hỏi thường gặp
Bài hướng dẫn nên có bao nhiêu bước?
Không có con số cố định. Nguyên tắc là mỗi bước một hành động chính. Nếu bài vượt quá khoảng mười lăm bước, nên chia thành các giai đoạn có tên riêng, mỗi giai đoạn vài bước, để người đọc biết mình đang ở đâu và có chỗ dừng nghỉ.
Có nên để AI viết toàn bộ bài hướng dẫn không?
Không nên với các bước thao tác. AI có thể đổi thứ tự, thêm bước không tồn tại hoặc dùng tên nút đã cũ. Bạn nên tự viết các bước khi đang làm thật, rồi dùng AI đóng vai người mới để tìm chỗ thiếu và gợi những cách người đọc có thể làm sai.
Cảnh báo nên đặt ở đâu trong bài hướng dẫn?
Đặt ngay tại bước liên quan, trước hành động có rủi ro. Nếu dồn hết cảnh báo xuống cuối bài, người đọc vừa làm vừa đọc sẽ gặp cảnh báo sau khi đã làm sai. Với rủi ro an toàn, nhắc thêm một lần ở phần chuẩn bị.
Làm sao kiểm bài hướng dẫn khi không có ai thử giúp?
Để bài vài ngày cho trí nhớ thao tác phai bớt, rồi tự làm lại đúng theo từng chữ trong bài, không làm theo thói quen. Kết hợp với việc nhờ AI đóng vai người mới đọc từng bước và chỉ ra chỗ không rõ.
Có cần ghi phiên bản phần mềm trong bài hướng dẫn không?
Nên ghi. Tên nút, vị trí menu và các bước thao tác thay đổi theo phiên bản. Một dòng ghi bài viết theo phiên bản nào, cập nhật ngày nào giúp người đọc biết hướng dẫn còn khớp hay không, và giúp bạn biết khi nào cần sửa.
Ảnh chụp màn hình trong bài hướng dẫn cần lưu ý gì?
Che mọi thông tin cá nhân trên ảnh như tên tài khoản, địa chỉ thư, số điện thoại, mã khách hàng. Chụp vừa đủ vùng cần nhìn, đánh dấu vị trí cần bấm, và đặt ảnh ngay sau bước tương ứng thay vì gom vào cuối bài.