Soạn một bài viết nội bộ

Nắm bắt bí quyết để cả đội có thể dùng lại.

Khi nào dùng

Hãy viết bài khi một câu trả lời đã bị lặp lại nhiều lần trong chat, hoặc một quy trình chỉ nằm trong đầu một người. Trình soạn hỗ trợ markdown có bảng, mã và ảnh, cùng các bố cục bài FAQ, Quy trình và Cây quyết định.

Trước khi bắt đầu

Cần quyền kb:write để tạo và sửa bài; chỉ cần kb:read để đọc.
Việc xuất bản có thể phải qua duyệt, do toggle knowledge.approval_required_for_publish quyết định (xem lưu ý bên dưới).
Lịch sử phiên bản phụ thuộc toggle knowledge.version_control (mặc định: bật).

⚠️

Giá trị mặc định của knowledge.approval_required_for_publish hiện đang lệch: khi chưa từng đặt, backend coi là tắt nhưng màn cài đặt lại hiển thị là bật. Hãy mở màn cài đặt và lưu lại tường minh để hành vi được chắc chắn.

Các bước

Vào /knowledge/kb và nhấp Bài viết Mới (mở /knowledge/kb/new).
Nhập tiêu đề, chọn bố cục bài (FAQ, Quy trình hoặc Cây quyết định), chọn danh mục và viết nội dung trong trình soạn markdown.
Thêm thẻ để bài hiện trong các tìm kiếm liên quan.
Lưu dưới dạng Nháp để tiếp tục chỉnh sửa, hoặc gửi duyệt. Nếu công ty không bắt buộc duyệt, bạn có thể xuất bản thẳng.
Muốn sửa sau này, mở bài rồi chọn chỉnh sửa (/knowledge/kb/edit/[id]). Trang chi tiết còn có nút in bài.

Cơ Sở Tri Thức Đội Nhóm — trình soạn bài viết nội bộ với danh mục và thẻ

Trạng thái bài viết

Trạng thái	Ý nghĩa
Nháp	Đang viết; chỉ người soạn làm việc trên bài
Chờ duyệt	Đang đợi người duyệt (chỉ khi công ty bắt buộc duyệt trước khi xuất bản)
Đã xuất bản	Mọi người có quyền `kb:read` đều thấy
Lưu trữ	Ngừng sử dụng

Mẹo & lỗi thường gặp

Luôn chọn danh mục: bài chưa phân loại không bao giờ hiện trên cổng công khai và khó duyệt hơn.
Mỗi bài một chủ đề; dùng bố cục Quy trình cho danh sách bước và FAQ cho câu hỏi ngắn.
Nếu bài không xuất bản thẳng từ nháp được, nghĩa là công ty bắt buộc duyệt; hãy gửi duyệt.
Dùng thẻ nhất quán (xem Phân loại wiki) để tìm kiếm ra đúng bài.

Liên quan

Tổng quan Phân loại wiki