Tiếp theoHướng dẫn tiếp theo
How to Beat Writer's Block with AI
Ứng dụng
HƯỚNG DẪN ứng dụng
AI dành cho người viết kỹ thuật có nghĩa là sử dụng mô hình ngôn ngữ để soạn thảo tài liệu từ thông số kỹ thuật và mã, giữ phong cách nhất quán và hỗ trợ quy trình làm việc dưới dạng mã, trong khi người viết chịu trách nhiệm về tính chính xác và cấu trúc.
Nghe hướng dẫn nàyAI thuật lại · ~3 min
Điều này quan trọng vì tài liệu thường bị tụt hậu so với các sản phẩm chuyển động nhanh. AI có thể tăng tốc độ soạn thảo và cập nhật, nhưng nó cũng có thể phát minh ra các tham số hoặc hành vi nghe có vẻ thuyết phục.
Viết kỹ thuật đã được tự động hóa một phần trong một thời gian dài. Tài liệu tham khảo được tạo thường xuyên từ nhận xét mã hoặc thông số kỹ thuật API bằng các công cụ như Swagger UI, Redoc và Sphinx autodoc. Những gì AI tổng hợp bổ sung là văn xuôi: giải thích khái niệm, hướng dẫn, ví dụ, ghi chú phát hành và bản thảo đầu tiên được viết từ tài liệu yêu cầu sản phẩm hoặc ghi chú kỹ thuật. Nhiều nhóm làm việc theo mô hình tài liệu dưới dạng mã. Tài liệu tồn tại dưới dạng Markdown hoặc reStructuredText trong Git, các thay đổi được thực hiện thông qua các yêu cầu kéo và tích hợp liên tục sẽ xây dựng trang web bằng trình tạo trang tĩnh như Docusaurus, MkDocs hoặc Sphinx. Thiết lập này rất phù hợp với AI. Bản nháp xuất hiện dưới dạng các thay đổi có thể xem lại, các bước kiểm tra tự động chạy trên mọi cam kết và các bản cập nhật tài liệu có thể được liên kết với các thay đổi mã gây ra chúng. Để có sự nhất quán về phong cách, các công cụ xác định và AI bổ sung cho nhau. Một kẻ nói dối như Vale thực thi các quy tắc từ một hướng dẫn về văn phong, ví dụ như hướng dẫn về văn phong trong tài liệu dành cho nhà phát triển của Google hoặc Hướng dẫn về phong cách viết của Microsoft và luôn đưa ra kết quả tương tự. AI có khả năng đề xuất cụm từ rõ ràng hơn nhưng khó dự đoán hơn. Rủi ro chính là sự thiếu tự tin. Một mô hình có thể phát minh ra điểm cuối, giá trị mặc định hoặc cờ dòng lệnh trông có vẻ hợp lý. Nó cũng có thể mô tả cách một sản phẩm hoạt động trong dữ liệu đào tạo của nó thay vì cách nó hoạt động hiện tại. Mọi mẫu mã và tham số được tạo đều cần được kiểm tra trên hệ thống thực. Một quan niệm sai lầm phổ biến là AI khiến người viết kỹ thuật trở nên không cần thiết. Phần khó khăn của công việc là biết điều gì là đúng, quyết định xem người dùng cần gì và sắp xếp thông tin để họ có thể tìm thấy nó. Các khung như Diátaxis, phân tách các hướng dẫn, hướng dẫn cách thực hiện, tài liệu tham khảo và giải thích, phản ánh công việc mang tính cấu trúc đó. Các vai trò đang chuyển sang cấu trúc thông tin, xác minh, chiến lược nội dung và viết cho người đọc AI. Ví dụ: đề xuất llms.txt từ năm 2024 đề xuất một tệp trỏ các mô hình ngôn ngữ tới tài liệu chính của trang web.
Một người viết cung cấp cho AI thông số kỹ thuật OpenAPI và mẫu trang của nhóm, đồng thời yêu cầu cung cấp cái nhìn tổng quan về khái niệm cũng như hướng dẫn bắt đầu. Sau đó, họ chạy mọi mẫu mã trên môi trường thử nghiệm.
Kho lưu trữ tài liệu chạy trình nói dối văn xuôi Vale trong quá trình tích hợp liên tục để gắn cờ các thuật ngữ bị cấm và giọng nói thụ động. Trợ lý AI gợi ý viết lại các câu được gắn cờ và người viết chấp nhận hoặc từ chối từng câu.
Khi yêu cầu kéo của kỹ sư đổi tên cờ cấu hình, bước AI sẽ soạn thảo thay đổi tài liệu phù hợp. Người viết xem xét nó trước khi sáp nhập.
Người viết sẽ cấu trúc lại một trang xử lý sự cố dài thành các phần độc lập với các tiêu đề mô tả. Điều đó giúp người đọc và trợ lý AI lấy các đoạn văn từ tài liệu.
Tài liệu có thể sẽ được tạo và cập nhật liên tục hơn, cùng với những thay đổi về mã, với khả năng soạn thảo của AI và sự phê duyệt của con người. Nhiều độc giả hơn sẽ tiếp cận tài liệu thông qua trợ lý AI thay vì duyệt, điều này làm tăng giá trị của nội dung chính xác, có cấu trúc tốt và hoạt động khi đọc theo từng phần. Các quy ước như llms.txt vẫn chỉ là đề xuất và việc áp dụng chúng là không chắc chắn. Nhu cầu soạn thảo thuần túy có thể giảm, trong khi nhu cầu về những người có thể kiểm tra độ chính xác kỹ thuật, kiến trúc thông tin thiết kế và chất lượng tài liệu của riêng mình có thể ổn định hoặc tăng lên. Thị trường việc làm sẽ phân chia như thế nào vẫn chưa rõ ràng.
Bản tin miễn phí
Ba câu chuyện AI đã được xác minh vào mỗi buổi sáng các ngày trong tuần, được viết bằng tiếng Anh đơn giản. Miễn phí mãi mãi, không có quảng cáo.
Một email mỗi ngày trong tuần. Hủy đăng ký trong một cú nhấp chuột. Chúng tôi không bao giờ bán hoặc chia sẻ địa chỉ của bạn.
Tự kiểm tra
Phản hồi tức thì về mọi câu trả lời và chứng chỉ có thể chia sẻ với ID có thể xác minh sau khi bạn vượt qua khóa học.
Hỗ trợ giáo dục AI miễn phí. AI Understanding là tổ chức phi lợi nhuận 501(c)(3) — không bao giờ có quảng cáo, không có tường phí. Hãy quyên góp
AI dành cho người viết kỹ thuật có nghĩa là sử dụng mô hình ngôn ngữ để soạn thảo tài liệu từ thông số kỹ thuật và mã, giữ phong cách nhất quán và hỗ trợ quy trình làm việc dưới dạng mã, trong khi người viết chịu trách nhiệm về tính chính xác và cấu trúc. Điều này quan trọng vì tài liệu thường bị tụt hậu so với các sản phẩm chuyển động nhanh. AI có thể tăng tốc độ soạn thảo và cập nhật, nhưng nó cũng có thể phát minh ra các tham số hoặc hành vi nghe có vẻ thuyết phục.
Vale là một kẻ nói dối bằng văn xuôi thực thi các quy tắc về phong cách một cách xác định. Các đề xuất của AI để diễn đạt rõ ràng hơn khó có thể dự đoán được hơn.
Trong tài liệu dưới dạng mã, tài liệu tồn tại trong Git dưới dạng Markdown hoặc tương tự, thực hiện các yêu cầu kéo và được CI xây dựng bằng trình tạo trang tĩnh.
Diátaxis tách tài liệu thành các hướng dẫn, hướng dẫn cách thực hiện, tài liệu tham khảo và giải thích, mỗi tài liệu phục vụ một nhu cầu khác nhau của người dùng.
Sự thiếu tự tin không chính xác là rủi ro chính. Các mẫu có thể thực thi làm cho tham số được phát minh không thành công trong quá trình xây dựng.
Được đề xuất vào năm 2024, llms.txt là quy ước hướng dẫn các mô hình ngôn ngữ cho các tài liệu quan trọng. Việc áp dụng nó vẫn chưa chắc chắn.
Tiếp tục học hỏi
Đã chọn thêm hướng dẫn cho chủ đề này
Tiếp theoHướng dẫn tiếp theo
How to Beat Writer's Block with AI
Ứng dụng