Viết dễ hiểu đôi khi khó nhất khi người viết đã biết quá nhiều. Có lần mình nhận một đoạn nội dung từ một đứa em. Đoạn ấy ngắn, không có lý thuyết sâu và cũng chẳng dùng công thức phức tạp. Mình đọc một lượt rồi nghĩ: “Khá đơn giản mà.”
Nhưng nếu là dân văn phòng mới tiếp cận AI, người đọc có thể dừng ngay ở câu hỏi: “Agent là gì?” Trong một đoạn được xem là dành cho người mới, agent, workflow, knowledge base và Markdown đã xuất hiện như những từ ai cũng biết. Cái giá không chỉ là vài phút tra cứu. Nguy hiểm hơn, người đọc có thể gật gù, đọc hết nhưng không hiểu đủ để làm theo.
Bài này giúp bạn nhận ra chỗ người đọc dễ vấp, giữ lại thuật ngữ cần thiết và dùng năm bước để đặt một chiếc thang trước khi mời họ bước vào phần chuyên môn.
Vì sao người biết nhiều lại khó viết dễ hiểu?
Điểm chính: Người viết càng quen một lĩnh vực càng khó nhớ lại cảm giác chưa biết. Những bước từng cần giải thích dần biến thành phản xạ, khiến họ bắt đầu ở tầng kiến thức cao hơn vị trí thật của người đọc.
Khi biết quá ít, mình thiếu điều để nói. Khi biết khá nhiều, một vấn đề khác xuất hiện: mình không còn nhìn thấy những viên gạch nền. Người làm marketing nói về định vị, insight và phễu chuyển đổi. Người làm vận hành nhắc SOP, phân quyền và điểm kiểm soát. Người dùng AI nói agent, RAG và context window. Các từ ấy có nghĩa rõ trong đầu người nói, nhưng chưa chắc đã tạo thành hình trong đầu người nghe.
Năm 1989, Colin Camerer, George Loewenstein và Martin Weber gọi một dạng sai lệch như vậy là “lời nguyền tri thức”. Trong các thí nghiệm về phán đoán, người có nhiều thông tin gặp khó khi gạt phần thông tin riêng của mình sang một bên để dự đoán người ít thông tin sẽ nghĩ gì. Nghiên cứu này không nói mọi bài khó hiểu đều do một thiên kiến. Nó chỉ đặt tên cho một lực kéo quen thuộc: điều mình đã biết luôn chen vào cách mình ước lượng người khác đang biết.
Trong công việc viết, lực kéo ấy làm người viết nhảy cóc. Mình kể từ tầng ba vì quên rằng ngày trước đã leo qua tầng một và tầng hai. Người đọc vẫn đứng dưới sân, nhìn thấy một loạt cửa sổ nhưng không biết cầu thang nằm ở đâu.
Vì vậy, viết dễ hiểu không bắt đầu bằng việc thay mọi từ khó bằng từ dễ. Nó bắt đầu bằng một câu hỏi khiêm tốn hơn: người đọc cần biết điều gì ngay trước câu này để bước tiếp mà không hụt chân?
Lời nguyền tri thức làm người viết bỏ quên điều gì?
Điểm chính: Lời nguyền tri thức khiến người viết bỏ quên ba thứ: điểm xuất phát của người đọc, nghĩa cụ thể của thuật ngữ trong bài và chuỗi bước đã giúp chính mình hiểu vấn đề. Bài vẫn đúng kiến thức nhưng thiếu đường đi.
Thứ đầu tiên bị bỏ quên là điểm xuất phát. Nhãn “dân văn phòng” nghe khá cụ thể, nhưng bên trong có người đã dùng công cụ AI mỗi ngày và người mới chỉ biết mở ChatGPT. Nếu mình gọi cả hai là người mới rồi dùng cùng một lượng thuật ngữ, brief đã rõ trên giấy nhưng vẫn mờ trong thực tế.
Thứ hai là nghĩa trong ngữ cảnh. “Workflow” có thể là một sơ đồ quy trình, một chuỗi tự động hóa hoặc đơn giản là thứ tự ai làm gì. Người viết thấy một nghĩa quen thuộc. Người đọc có thể ghép từ đó với một nghĩa khác. Hai người đi hết cùng một đoạn nhưng thực ra đang nhìn hai bản đồ.
Thứ ba là các bước trung gian. Mình từng học agent sau khi đã hiểu mô hình AI, prompt, dữ liệu đầu vào, quyền truy cập và bước con người duyệt. Vài tháng sau, tất cả nén thành một từ. Khi viết, mình đặt từ “agent” lên trang mà quên mở phần kiến thức đã bị nén ấy ra.
Dấu hiệu dễ thấy nhất là một đoạn có nhiều danh từ nhưng ít hành động. “Triển khai agent theo workflow kết nối knowledge base” nghe gọn với người trong nghề. Người mới lại chưa biết ai làm gì, dữ liệu nằm đâu và kết quả được gửi cho ai.
Muốn viết dễ hiểu, hãy khoanh những từ mình dùng hằng ngày rồi hỏi: nếu bỏ từ này đi, mình sẽ mô tả công việc nào đang thật sự xảy ra? Câu trả lời thường chính là bậc thang đầu tiên.
Thuật ngữ chuyên môn có phải là vấn đề?
Điểm chính: Thuật ngữ chuyên môn không phải kẻ có lỗi. Vấn đề xuất hiện khi người viết dùng tên gọi trước khi người đọc thấy tình huống, công dụng hoặc ranh giới của khái niệm. Giữ đúng tên, nhưng đặt nó sau một điểm tựa quen thuộc.
Viết dễ hiểu không đồng nghĩa với xóa sạch thuật ngữ. Có những khái niệm cần được gọi đúng tên để người đọc tìm thêm, trao đổi với đồng nghiệp hoặc phân biệt chúng với khái niệm gần giống. Nếu thay “AI agent” bằng “một thứ AI làm việc” trong cả bài, câu chữ có vẻ nhẹ nhưng kiến thức lại mơ hồ.
Cách tốt hơn là gọi việc trước, gọi tên sau. Chẳng hạn: “Một trợ lý đọc dữ liệu được giao, thực hiện vài bước trong phạm vi cho phép rồi gửi kết quả để con người duyệt. Cách tổ chức này thường được gọi là AI agent.” Người đọc đã có một cảnh làm việc trong đầu trước khi nhận nhãn chuyên môn. Khi muốn xem ứng dụng cụ thể hơn, họ có thể đọc bài về AI agent qua những ứng dụng cụ thể.
Knowledge base cũng vậy. Mở bằng “xây dựng knowledge base” khiến người mới phải hiểu giải pháp trước khi thấy vấn đề. Mở bằng “tài liệu nằm ở năm nơi và không ai biết bản nào còn hiệu lực” lại tạo một điểm bám. Sau đó, knowledge base có thể được giới thiệu như một nơi tập hợp kiến thức đã được tổ chức để người hoặc hệ thống tìm lại. Bài Knowledge Hub đơn giản để bắt đầu tiếp tục ý này từ góc công cụ và cấu trúc.
Nguyên tắc là giữ thuật ngữ khi nó giúp tăng độ chính xác. Giải thích thuật ngữ khi người đọc cần nó để theo mạch. Bỏ thuật ngữ khi nó chỉ giúp câu nghe chuyên nghiệp hơn mà không thêm nghĩa.
Bậc thang nào giúp người mới theo kịp?
Điểm chính: Một bậc thang dễ dùng gồm bốn nấc: tình huống quen thuộc, việc cần giải quyết, tên thuật ngữ và cơ chế đủ dùng. Trình tự này cho người đọc lý do để quan tâm trước khi yêu cầu họ ghi nhớ một khái niệm mới.
Nấc đầu tiên là tình huống. Đừng mở bằng “RAG là một kiến trúc”. Hãy bắt đầu ở nơi người đọc đang đứng: chatbot trả lời sai vì không nhìn thấy tài liệu nội bộ. Cảnh cụ thể giúp họ nhận ra vấn đề trước khi học từ mới.
Nấc thứ hai là công dụng. Nói rõ ta muốn hệ thống tìm tài liệu liên quan để tạo câu trả lời có căn cứ hơn. Người đọc chưa biết tên kỹ thuật nhưng đã hiểu thay đổi trong công việc.
Nấc thứ ba mới là tên gọi. Lúc này có thể giới thiệu RAG là cách lấy thông tin liên quan từ nguồn dữ liệu rồi đưa vào ngữ cảnh để mô hình trả lời. Tên gọi được gắn vào một việc đã hiểu, nên nó không còn lơ lửng.
Nấc cuối là cơ chế đủ dùng. Bài nhập môn chỉ cần nói dữ liệu được tìm, chọn và đưa vào câu hỏi. Bài kỹ thuật mới cần đi sâu vào embedding, vector database hoặc đánh giá truy xuất. Hiểu sâu là biết dừng đúng tầng.
WHO khuyên người viết cho đối tượng không chuyên nên đưa điểm quan trọng lên trước, chia thông tin phức tạp thành phần dễ hiểu và dùng ngôn ngữ đơn giản để giải thích thuật ngữ. Style Manual của Chính phủ Australia cũng nhấn mạnh việc ưu tiên từ quen thuộc, giải thích từ lạ và mở rộng chữ viết tắt ở lần đầu.
Bốn nấc này không làm kiến thức nông đi. Chúng giúp viết dễ hiểu bằng cách trao cho người đọc đúng thứ tự mà người viết từng cần, chỉ gọn hơn và có chủ đích hơn.
5 bước sửa một đoạn quá nhiều thuật ngữ
Điểm chính: Muốn sửa một đoạn nhiều thuật ngữ, đừng thay từ ngay. Hãy xác định hành động người đọc cần làm, khoanh điểm vấp, dựng ví dụ, giới thiệu tên gọi rồi nhờ một người gần với độc giả đọc thử. Thứ tự quan trọng hơn việc làm câu thật ngắn.
Chốt một kết quả đọc. Hỏi: “Đọc xong, người đọc có thể làm hoặc quyết định gì?” Nếu câu trả lời là “hiểu hơn”, mục tiêu vẫn quá mờ. Với agent, kết quả có thể là phân biệt agent với chatbot.
Khoanh từ có thể gây vấp. Đánh dấu thuật ngữ, chữ viết tắt và từ nội bộ. Cả “điểm kiểm soát” hoặc “phân quyền” cũng có thể mang nghĩa khác với người mới.
Viết tình huống không dùng thuật ngữ. Mô tả công việc hoặc rắc rối bằng động từ. Nếu không thể bỏ chính tên của khái niệm, có thể mình chưa hiểu phần lõi đủ rõ.
Đưa tên gọi trở lại. Gắn thuật ngữ vào tình huống bằng một câu định nghĩa ngắn rồi dùng nhất quán. Đừng đổi giữa knowledge base, kho tri thức và bộ nhớ nếu chưa phân biệt chúng.
Kiểm tra bằng câu hỏi làm được. Đừng hỏi “Có dễ hiểu không?”. Hãy hỏi thuật ngữ này giải quyết việc gì và bước tiếp theo là gì. Một cái gật đầu chưa chứng minh khả năng hành động.
Điểm cần nhớ khi viết cho người mới
Điểm chính: Viết cho người mới không yêu cầu người viết giả vờ biết ít. Người viết cần giữ độ chính xác, chọn đúng tầng kiến thức và cho người đọc một hành động kiểm tra được. Sự rõ ràng là kết quả của hiểu sâu và biết tiết chế.
Giải thích có thể làm bài dài dòng nếu chỉ lặp định nghĩa hoặc kể ví dụ không dẫn tới hành động. Nó cần thiết khi mỗi bậc trả lời một câu hỏi người đọc buộc phải hiểu để đi tiếp.
Một bài chuyên môn không cần giải thích mọi từ. Hãy ưu tiên từ nằm trên đường đi của ý định tìm kiếm. Nếu bài hướng dẫn tạo agent, “agent” và “quyền truy cập” cần rõ. Tiết chế là chọn đúng điểm vấp, không phải cắt sạch bối cảnh.
- Bắt đầu từ việc người đọc đang làm, không bắt đầu từ sơ đồ trong đầu người viết.
- Giữ thuật ngữ giúp tăng độ chính xác, nhưng giải thích ở lần đầu cần thiết.
- Dùng một ví dụ để tạo hình, rồi quay lại khái niệm để tránh hiểu sai.
- Mỗi phần trả lời một câu hỏi và dẫn tới một bước nhỏ.
- Kiểm tra bằng khả năng giải thích hoặc hành động, không kiểm tra bằng cái gật đầu.
Điều khó không phải là nói hết những gì mình biết. Điều khó là nhớ lại cảm giác trước khi biết, rồi đặt đúng một bậc ở nơi người đọc sắp hụt chân.
Những câu hỏi thường gặp về viết dễ hiểu
Điểm chính: Một bài rõ không né thuật ngữ, không xem người đọc là thiếu năng lực và không dựa hoàn toàn vào điểm readability. Nó cho đúng bối cảnh, đúng tên gọi và một cách kiểm tra xem người đọc có dùng được kiến thức hay chưa.
Có nên bỏ toàn bộ thuật ngữ tiếng Anh?
Không. Giữ từ độc giả cần để tìm kiếm hoặc trao đổi chính xác. Ở lần đầu, giải thích bằng tiếng Việt và gắn với tình huống. Nếu từ không thêm độ chính xác, có thể bỏ.
Nên giải thích thuật ngữ trước hay sau khi dùng?
Thường nên cho người đọc thấy tình huống hoặc công dụng trước, rồi giới thiệu tên. Với thuật ngữ đã rất quen trong nhóm độc giả, có thể dùng trước và giải thích ngay trong cùng câu. Đừng để người đọc chờ nhiều đoạn mới biết từ đó nghĩa là gì.
Ví dụ có thay được định nghĩa không?
Không hoàn toàn. Ví dụ giúp người đọc tạo hình, còn định nghĩa đặt ranh giới cho khái niệm. Cách an toàn là dùng ví dụ ngắn, sau đó chốt một câu nêu khái niệm gồm gì hoặc khác điều gần giống ở đâu.
Có thể dùng AI để sửa bài khó hiểu không?
Có, nhưng cần cung cấp chân dung độc giả và yêu cầu AI chỉ ra thuật ngữ, giả định nền cùng bước bị nhảy. Người viết vẫn phải duyệt vì AI không biết trải nghiệm thật của độc giả.
Làm sao biết bài đã đủ dễ hiểu?
Đưa bài cho một người gần với độc giả mục tiêu. Hỏi họ nội dung giúp giải quyết việc gì, một thuật ngữ chính nghĩa là gì và họ sẽ làm bước nào tiếp theo. Nếu họ trả lời được bằng lời của mình, chiếc thang đã bắt đầu làm đúng việc.
Bửu Trung, Dân Lười, thích Tối ưu
