- Cảnh báo rằng việc dừng tuyển dụng hoặc sa thải vì “niềm tin rằng AI có thể thay thế người viết tài liệu kỹ thuật” là một sai lầm nghiêm trọng
- Tài liệu do AI tạo ra không có trí tuệ hay sự đồng cảm, và chỉ là một cái vỏ rỗng không thể chứa đựng sự thật và ngữ cảnh của sản phẩm
- Technical writer là lực lượng nòng cốt giúp sản phẩm trở nên dễ hiểu thông qua sự đồng cảm với người dùng, thu thập thông tin và truyền đạt rõ ràng
- “Viết tài liệu kỹ thuật tăng cường” kết hợp công cụ AI với chính sách là phương án thay thế thực tế giúp nâng cao năng suất
- AI tạo ra nhiễu, còn con người tạo ra tín hiệu - kêu gọi đưa technical writer trở lại và tuyển dụng lại họ
Vấn đề của việc phụ thuộc vào AI để thay thế technical writer
- Quyết định sa thải hoặc không tuyển dụng technical writer (Technical Writer) vì AI là một sai lầm lớn
- Nếu chỉ dựa vào tài liệu do AI viết, kết quả sẽ thiếu sự giám sát của chuyên gia và thiếu hiểu biết về ngữ cảnh
- Chuyển gánh nặng viết tài liệu sang cho lập trình viên là một hành động hiểu sai bản chất của tài liệu
- Tài liệu kỹ thuật không chỉ là một đầu ra đơn thuần mà là thành phần cốt lõi chứa đựng sự thật của sản phẩm (product truth)
- Phần mềm chưa hoàn thiện, không tự hiển nhiên và cũng không đơn giản, nên không thể sử dụng nếu không có tài liệu
- Technical writer kết nối sản phẩm thông qua thu thập thông tin, diễn đạt rõ ràng và lối trình bày lấy người dùng làm trung tâm
Giới hạn của tài liệu do AI tạo ra
- Tài liệu do AI tạo ra không có trí tuệ và thiếu tầm nhìn
- Dù học từ hàng triệu token, AI vẫn không thể xây dựng chiến lược tài liệu, cấu trúc hóa hay thiết kế khả năng tái sử dụng
- AI không nắm bắt được các tình huống ngoại lệ, ranh giới tinh tế và trạng thái căng thẳng của sự chưa hoàn thiện, nên nội dung trở nên rỗng tuếch
- Trách nhiệm pháp lý vẫn thuộc về con người chứ không phải AI
- Nếu hướng dẫn sai gây ra thiệt hại, trách nhiệm sẽ thuộc về quản lý hoặc doanh nghiệp
- Không thể sa thải hay đưa mô hình AI ra tòa, nên không thể né tránh trách nhiệm
- Để AI tạo tài liệu, cần có ngữ cảnh (context) chất lượng cao sẵn có
- RAG, quy tắc Cursor, Claude Skills... tất cả đều là phần mở rộng của công việc viết tài liệu kỹ thuật
- Nếu sa thải người viết tài liệu, chính dữ liệu nền tảng để AI học cũng sẽ biến mất
Khả năng cộng tác giữa technical writer và AI
- Nếu cung cấp công cụ AI và đào tạo, năng suất của technical writer có thể tăng đáng kể
- Có thể xây dựng môi trường viết tài liệu kiểu tương lai, nơi con người cộng tác với AI đồng thời bảo vệ chất lượng thông qua chính sách AI
- Đã có những technical writer tận dụng AI để tự động hóa việc viết, biên tập và xuất bản
- CEO AWS Matt Garman cũng thừa nhận việc tăng năng suất theo hướng hỗ trợ con người thay vì thay thế họ hoàn toàn
- Doanh nghiệp cần cùng technical writer xây dựng chiến lược AI và cung cấp thời gian, nguồn lực để thử nghiệm
- Technical writer vốn đã có khả năng tối đa hóa hiệu quả với nguồn lực hạn chế
- Nếu được cung cấp công cụ và cơ hội phù hợp, họ có thể tận dụng AI để nâng cao chất lượng tài liệu
Lời kêu gọi tuyển dụng lại và thay đổi nhận thức
- Cần từ bỏ tiền đề sai lầm rằng AI đã hoàn toàn thay thế vai trò của con người
- Viết tài liệu kỹ thuật không đơn thuần là ghép chữ, mà còn bao gồm phỏng vấn chuyên gia, hiểu sản phẩm và diễn giải ngữ cảnh
- Technical writer không phải là xa xỉ mà là nhân lực thiết yếu, đóng vai trò người phiên dịch giúp sản phẩm có thể được sử dụng
- Không có họ, sản phẩm sẽ không thể tự giải thích chính mình hoặc sẽ truyền tải thông tin sai lệch
- Kết lại bằng nhận định rằng AI có thể tạo ra tiếng ồn vô hạn, nhưng con người tạo ra tín hiệu có ý nghĩa
- Kêu gọi đưa những Technical Writer đã bị sa thải trở lại và cùng làm việc với họ
2 bình luận
Vấn đề không phải là AI hay con người,
mà mấu chốt là có thể thực hiện được "đồng cảm với người dùng, thu thập thông tin, truyền đạt rõ ràng" hay không.
Ý kiến Hacker News
Tôi là người làm viết tài liệu một cách chuyên nghiệp
Nhưng công việc thực sự của tôi là quan sát, lắng nghe và thấu hiểu
Muốn viết tốt thì phải hiểu sâu sự lo lắng và bối rối của độc giả
Mỗi khi trải nghiệm hệ thống giao thông công cộng ở nước ngoài, tôi lại chỉnh sửa hướng dẫn giao thông địa phương
Tôi cải thiện bài viết bằng cách trực tiếp trải nghiệm sự bối rối từ góc nhìn của độc giả
Sự đồng cảm là động cơ vận hành công việc của tôi
Qua nhiều năm, tôi đã xây dựng hạ tầng để thu thập thông tin nhờ các mối quan hệ tin cậy với con người
AI chỉ xử lý những gì đã được ghi lại, còn tôi thì trực tiếp bước ra thế giới và đặt câu hỏi
Tôi đã tạo công cụ để thu thập trải nghiệm với cơ quan nhập cư, và phỏng vấn hàng trăm luật sư cùng chuyên gia
AI phụ thuộc vào dữ liệu, còn tôi tự đi săn dữ liệu của mình
Tin rằng AI có thể thay thế công việc này là một sự hiểu sai mang tính xúc phạm về nghề nghiệp
Tài liệu giao thông công cộng có tệ đi thì doanh thu cũng không giảm ngay
Nhưng sa thải technical writer thì ngân sách giảm ngay lập tức
Phần mềm cũng vậy — rào cản gia nhập cao đến mức khó mà nói “cái này dở quá, tôi sẽ tự làm cái tốt hơn”
Code là tài liệu mà máy tính đọc
Máy tính không có lẽ thường, nên mọi sự hiểu biết đều phụ thuộc vào lập trình viên
LLM tạo ra câu đúng ngữ pháp không có nghĩa là viết được tài liệu tốt
Tương tự, tạo ra code biên dịch được không có nghĩa là tạo ra chương trình mà người dùng muốn
Tôi diễn đạt cùng ý đó bằng câu “công nghệ cần có linh hồn”
Tài liệu kỹ thuật, UI và sản phẩm đều chỉ có giá trị khi thấm đẫm cảm giác con người
Tham vọng thay thế con người của AI là xúc phạm
Chúng ta không ghi lại mọi thứ — càng là điều hiển nhiên thì càng ít được ghi lại, nhưng AI lại rất cần kiểu dữ liệu đó
Tôi không làm ở công ty đã sa thải technical writer, nhưng công ty tôi cũng trải qua chuyện tương tự
Vì các writer phụ thuộc vào AI nên kết quả kinh khủng, và bản thân họ gần như không thể tự viết
Thật khó tìm technical writer giỏi trên thị trường, và kể cả portfolio đẹp thì thực tế nhiều khi vẫn rất tệ
Cuối cùng lại giao tài liệu cho dev làm — nhưng dev thì không muốn đưa việc đó vào sự nghiệp của mình
Sa thải một writer dù chỉ tạm ổn cũng là cách phá hỏng doanh nghiệp
AI mạnh với dữ liệu có mẫu hình ổn định như README hay config, nhưng yếu với nội dung độc nhất như tài liệu sản phẩm
Có những loại tài liệu AI làm tốt — loại không ai đọc, chỉ để tuân thủ quy định
Những tài liệu này chỉ định nghĩa các thuật ngữ cơ bản như CPU, còn thuật ngữ miền quan trọng thì lại thiếu
Chúng đầy những tham chiếu đến tài liệu không truy cập được, UML không khớp với code, chữ ký cũ, ảnh chụp màn hình mỗi nơi một kiểu
Định dạng cũng lộn xộn, nên ngoài một QA manager buồn chán ra thì chẳng ai đọc
Thay vào đó, nếu cung cấp nhiều ví dụ cụ thể thì AI sẽ giúp tốt hơn
Technical writer giỏi nhất không chỉ đơn thuần ghi chép về sản phẩm
Họ hành xử như người dùng thực sự và tìm ra vấn đề về tính khả dụng
Họ có khả năng kéo ra thông tin cần thiết thông qua phỏng vấn 1:1 với kỹ sư
AI không làm tốt vai trò này
Ngay cả trong nội bộ, phản hồi ấn tượng ban đầu với nội dung lần đầu nhìn thấy cũng cực kỳ quan trọng
Nhưng nhiều tổ chức lại cản trở văn hóa phản hồi giữa các bộ phận
Kết quả là nội dung kỹ thuật phục vụ marketing thường mơ hồ và vô nghĩa
Vì nhiều dự án hoặc không có tài liệu, hoặc tài liệu rất tệ
Họ là người đầu tiên nhận ra workflow phức tạp có vấn đề
Họ cũng thường có cảm quan kỹ thuật, chẳng hạn biết dùng các ngôn ngữ như Python
AI có thể thay thế technical writer, nhưng không phải là vật thay thế tốt
Những công ty có tài liệu tốt nhất vẫn sẽ giữ writer là con người
Nhiều người lầm tưởng rằng “ai cũng viết được”, nhưng thực tế không phải vậy
(Bài liên quan: Nobody Can Write)
Technical writer còn đóng góp cho UX và kiểm thử, và thường là người đầu tiên phát hiện sự không nhất quán trong quy ước đặt tên API
AI dùng làm công cụ hỗ trợ thì ổn, nhưng xuất bản nguyên xi mà không biên tập là rất nguy hiểm
Xem thảo luận liên quan ở bình luận này
Technical writer giỏi nhất giống như nhà nhân học, bắc cầu giữa đội sản phẩm, kỹ sư và người dùng
Chính góc nhìn đó giúp cải thiện cả bản thân sản phẩm
Việc viết tài liệu bị đẩy sang cho dev, và chỉ còn lại mệnh lệnh “cứ dùng AI đi”
Tôi tự hỏi liệu đây có thật sự là tương lai đã được hứa hẹn hay không
nhưng không có cảm giác để nhận ra khoảng cách văn hóa giữa con người với nhau
Tôi muốn tiếp tục nâng cao kỹ năng viết và năng lực giao tiếp vào năm 2026
Những kỹ năng này không dễ bị thay thế
Tự mình học được chúng sẽ thay đổi cách suy nghĩ, và còn giúp ích cho những lĩnh vực khác trong đời sống
Sự biến mất của nâng cấp kỹ năng ở con người mới là tổn thất thực sự
Văn phong đồng nhất của LLM rất nhanh gây ngán
Về dài hạn, có thể việc tăng tốc không bù nổi sự suy giảm kỹ năng
Lúc đầu tôi thấy tiêu đề hơi khó hiểu
Tôi tưởng đó là “bức thư gửi tới những writer bị sa thải vì bị phát hiện dùng AI”
Toàn bộ bài viết mơ hồ về mặt ngôn ngữ, khiến tôi lại càng giảm niềm tin vào writer là con người
Tôi cũng học chuyên ngành văn học Anh và CS, từng dạy viết cho nghiên cứu sinh tiến sĩ,
và hiện trực tiếp quản lý tài liệu công ty
nên cách hiểu thứ hai (“writer bị thay thế bởi AI”) lại tự nhiên hơn
Có điều đáng học từ các công ty bảo hiểm
Họ dùng AI để tìm lý do từ chối các yêu cầu bồi thường chính đáng
Khi ra tòa thì né trách nhiệm bằng cách nói đó là “lỗi phần mềm”
Tôi hy vọng kiểu ngụy biện này sẽ không trở thành tiêu chuẩn
Có nên kỳ vọng rằng LLM sẽ tiếp tục cải thiện trong tương lai không?
Nhiều bài viết mặc định rằng những giới hạn hiện tại sẽ tồn tại mãi mãi
Việc phớt lờ khả năng tiến bộ khiến tôi thấy khá thiển cận
Mức kỳ vọng ở mỗi người là khác nhau