Anh em dev chúng ta có một sự thật đau lòng: Code thì hùng hục cày ngày đêm, mà bảo viết docs thì lẩn như chạch. Hậu quả là tính năng đã update đến phiên bản 2024 rồi mà tài liệu hướng dẫn vẫn kẹt ở năm 2022. Thời buổi mấy cái ai tools lên ngôi, giải pháp cho bài toán nhức nhối này rốt cuộc cũng lộ diện trên Product Hunt với cái tên Mintlify Workflows.
Tóm tắt nhanh cho anh em lười đọc: Mintlify vừa ra mắt Workflows - một dàn automation xịn xò con bò giúp knowledge base (tài liệu nội bộ, docs cho user) tự động cập nhật mà đ*o cần (hoặc cần rất ít) sức người. Thay vì cứ chạy theo từng cái pull request (PR) để sửa docs, anh em chỉ cần setup một lần và để AI lo phần còn lại.
Cụ thể bọn này làm được gì?
Nghe qua thì đúng là mượt. Nó biến cái việc viết docs từ một cục nợ thủ công thành một background process chạy ngầm.
Kéo xuống phần comments trên Product Hunt, anh em sẽ thấy đủ các cung bậc cảm xúc của giới dev.
Phe tung hô: "Viết docs bằng tay là nguyên thủy" Nhiều anh em mừng như bắt được vàng. Có ông thốt lên: "Tuyệt vời, từ nay đ*o bao giờ phải đi ăn vạ tụi nó update docs nữa". Phía Mintlify cũng chia sẻ một sự thật phũ phàng: Từ khi bật tool này lên, họ mới tá hỏa nhận ra kỹ sư của mình toàn "bỏ quên" docs. Gần 20% số lượng code changes (như đổi tên biến, đổi rate limit) lẽ ra phải đi kèm update docs, nhưng dev thì cứ nhắm mắt bấm merge.
Phe thực tế: Chất lượng phụ thuộc vào "đầu vào" Một pháp sư ẩn danh đặt câu hỏi rất chí mạng: Changelog tự gen ra là đọc từ commit message hay đọc từ code diff? Founder Mintlify phản hồi rằng con agent của họ sẽ clone repo về một máy ảo (VM) và đọc thẳng vào diffs của code để lấy context, thay vì chỉ phụ thuộc vào dăm ba cái commit message kiểu "fixed bug", "update" tào lao của anh em.
Phe hoài nghi: "Lòng tin" là thứ dễ toang nhất Đây là phần cao trào nhất. Một lão quái trong làng dev chỉ ra rằng: Docs là thứ đ*o có chỗ cho sự sai số. Nếu AI đọc PR merge và tự sửa docs sai (do edge case ẩn mà code diff không hiện rõ), hậu quả sẽ cực kỳ thảm họa.
Hãy tưởng tượng một dòng API reference bị AI sinh ra sai lệch. Dev team khác lấy về tích hợp, code sập server, và họ sẽ tự chửi bản thân mình ngu trước khi nhận ra docs viết sai. Một khi user phát hiện ra docs do AI viết bị "ngáo", lòng tin vào hệ thống tài liệu sẽ bốc hơi sạch.
Tóm cái váy lại, Mintlify Workflows là một bước tiến rất ma giáo và đáng hoan nghênh. Nó giải quyết đúng cái "pain point" (nỗi đau) chí mạng của mọi team product: Tốc độ ship code luôn vả vỡ mồm tốc độ viết docs.
Tuy nhiên, bài học sinh tồn ở đây là: AI sinh ra để gánh tạ, không phải để thay não. Chính founder của Mintlify cũng phải thừa nhận rằng, với những thứ rủi ro thấp như dịch thuật thì cứ để auto-merge, nhưng với những update liên quan đến Core API hay Code Sync, thì vẫn bắt buộc phải có một layer "human approval" (người thật việc thật duyệt lại).
Đừng quá lạm dụng automation để rồi đến một ngày, chính anh em đọc docs của team mình còn đ*o hiểu con AI nó đang chém gió cái gì.
Mintlify vừa tung tính năng Workflows dùng AI tự cập nhật docs, gen changelog theo PR. Cứu tinh cho dev lười hay lại là một cú lừa 'ngáo đá' của pháp sư AI? Hóng ngay!
