Source document: docs/knowledge-index/06-KNOWLEDGE-LIFECYCLE.md
Source version: 0.0.0
Generated time: 2026-07-06T14:59:18.117Z
Owner: Engineering (Enablement)
Audience: Internal
Status: Approved

06 — KNOWLEDGE LIFECYCLE

Vòng đời tài liệu + quy định khi nào sửa + chống trùng lặp. Áp cho mọi doc trong docs/. Neo văn hoá: engineering/01 §Documentation Rules, engineering/07-ADR.

Vòng đời

Draft ──> Review ──> Approved ──> (Deprecated) ──> Archived

Trạng thái	Nghĩa	Ai chuyển
Draft	Đang viết, chưa dùng làm nguồn chính thức	author
Review	Mời owner nhóm (05-DOCUMENT-OWNERS) + bên liên quan	author
Approved	Nguồn chính thức; các doc khác tham chiếu được	owner nhóm
Deprecated	Không còn đúng, chưa có thay thế (đánh dấu, giữ lại)	owner
Archived	Lịch sử; chuyển `docs/_archive/` hoặc nhãn rõ	owner

Doc quyết định kiến trúc → thêm bằng ADR (immutable) thay vì sửa tại chỗ (engineering/07).
Trạng thái ghi ở đầu doc khi cần (front-matter/nhãn); mặc định doc trong docs/* hiện tại coi là Approved trừ khi đánh dấu khác.

Khi nào SỬA docs

Bắt buộc sửa cùng PR khi code/contract/hành vi đổi (một phần engineering/04 DoD). Doc lỗi thời = nợ.
Sửa tại chỗ cho: cập nhật trạng thái, sửa lỗi, thêm cross-ref, cập nhật số liệu thật.
KHÔNG sửa tại chỗ cho: đảo quyết định kiến trúc đã Approved → tạo ADR mới "Supersedes" (engineering/07); thay đổi lớn/xuyên đội → RFC trước (engineering/06).
Đổi thuật ngữ canonical (Account/Customer/Partner/Tenant…) → sửa 04-GLOSSARY trước, rồi lan (không sửa rải rác gây mâu thuẫn).

Quy định KHÔNG tạo docs trùng

Tìm trước khi tạo. Kiểm 01-DOCUMENT-MAP + 00-HOME: đã có doc phủ chủ đề chưa? Có → cập nhật/tham chiếu, không tạo mới.
Reference, không copy. Một sự thật, một nơi. Cần dùng lại nội dung → link, không chép (chép = 2 nguồn lệch nhau).
Một chủ đề, một owner doc. Nếu hai doc chồng chủ đề → gộp hoặc phân ranh giới rõ (vd Account-lifecycle *thương mại* vs Tenant-lifecycle *kỹ thuật* — cùng thực thể, khác góc, có ánh xạ).
Định nghĩa canonical chỉ ở một chỗ: thuật ngữ → 04-GLOSSARY; entity SoT → 02-ENTITY-MAP; quan hệ → 03-RELATIONSHIP-MAP.
Tạo doc mới → thêm vào 00-HOME + 01-DOCUMENT-MAP + gán owner (05).

Chống link gãy & drift

Sửa/di chuyển/xoá doc → cập nhật mọi link tới nó (grep repo). Knowledge Index là nơi tập trung link → kiểm ở đây trước.
Review định kỳ (mỗi quý): quét doc lỗi thời/Deprecated, link gãy, định nghĩa lệch glossary.
Doc bị thay → đánh dấu Deprecated + trỏ tới doc mới; không xoá lịch sử đột ngột (giống ADR).

Nguyên tắc

Tài liệu là code: review, versioned (git), có owner, có vòng đời.
Không bịa: số liệu truy nguồn thật; chưa có → đánh dấu ⏳, không điền số giả.
Đủ, không thừa: index & dẫn nguồn; tránh phình trùng lặp.

Nguồn sự thật (Source of Truth): docs/knowledge-index/06-KNOWLEDGE-LIFECYCLE.md · v0.0.0 · sinh tự động lúc 2026-07-06T14:59:18.117Z. Trang này là view suy dẫn — không sửa trực tiếp.