Tài liệu này ghi lại một số ghi chú liên quan tới định hướng phát triển của Init Docs. Nội dung không mang tính hướng dẫn sử dụng, mà nhằm cung cấp bối cảnh và triết lý phát triển cho người dùng và developer quan tâm.
Init Docs không phải theme đa năng
Init Docs được xây dựng với phạm vi sử dụng rõ ràng: website tài liệu, knowledge base và wiki kỹ thuật.
Theme không hướng tới việc trở thành một giải pháp đa năng cho mọi loại website. Các tính năng không phục vụ trực tiếp cho tài liệu sẽ không được ưu tiên đưa vào.
Ưu tiên sự ổn định hơn số lượng tính năng
Định hướng phát triển của Init Docs tập trung vào:
- Giữ cấu trúc code rõ ràng và dễ bảo trì
- Tránh thêm tính năng gây phức tạp không cần thiết
- Đảm bảo các tính năng hiện có hoạt động ổn định lâu dài
Việc bổ sung tính năng mới chỉ được xem xét khi thực sự cần thiết cho hệ thống tài liệu.
Không phụ thuộc page builder
Init Docs không được thiết kế xoay quanh page builder.
Theme ưu tiên:
- Nội dung HTML sạch
- Editor truyền thống hoặc block editor ở mức cơ bản
- Markup dễ đọc và dễ tuỳ biến
Cách tiếp cận này giúp website tài liệu tránh bị khoá chặt vào một công cụ cụ thể.
Tập trung vào trải nghiệm đọc và tra cứu
Mọi quyết định thiết kế trong Init Docs đều xoay quanh hai yếu tố:
- Khả năng đọc rõ ràng
- Khả năng tra cứu hiệu quả
Các yếu tố trình diễn, hiệu ứng hoặc tương tác chỉ được sử dụng khi không làm gián đoạn hai yếu tố trên.
Phát triển theo hướng mở rộng có kiểm soát
Init Docs cho phép mở rộng thông qua:
- Child theme
- Hook và filter của WordPress
- Plugin bên ngoài
Theme không cố gắng bao phủ mọi nhu cầu, mà để hệ sinh thái WordPress đảm nhiệm phần còn lại.
Tài liệu là một phần của sản phẩm
Trong định hướng của Init Docs, tài liệu không phải phần phụ sau cùng.
Tài liệu được xem là một phần của sản phẩm hoặc hệ thống, cần được:
- Thiết kế nghiêm túc
- Duy trì lâu dài
- Cập nhật có kiểm soát
Init Docs được tạo ra để phục vụ tư duy này.
Tổng kết
Chuyên mục Ghi chú phát triển tồn tại để ghi lại các quyết định và định hướng dài hạn của Init Docs. Nội dung trong chuyên mục này không nhằm hướng dẫn sử dụng, mà giúp người đọc hiểu rõ hơn triết lý và cách tiếp cận đằng sau theme.