Gitbook là gì ?

https://www.gitbook.com/ Gitbook là một nền tảng dùng để ghi lại những thông tin kĩ thuật cần thiết, có thể sử dụng để tạo documents cho sản phẩm, hoặc dùng như một wiki chia sẻ thông tin, kiến thức nội bộ trong một dự án.

Tại sao nên sử dụng Gitbook ?

Gitbook có nhiều ưu điểm thuận tiện cho việc sử dụng đúng mục đích tạo Product Docs, đặc biệt trong lĩnh vực coding: + Có thể import trực tiếp file markdown, html, hoặc file MS word để tạo document. + Có hỗ trợ cơ chế request merging: Những thay đổi trên docs cần được approve mới có thể có thay đổi như git -> đảm bảo được tính nhất quán và chính xác về thông tin sản phẩm hoặc thông tin dự án. Khi sử dụng trong một tổ chức có thể tạo ra những role cụ thể trong dự án (có tính phí). + Có hỗ trợ live editing: thao tác trực tiếp trên docs để tạo change request ngay lập tức không cần qua thao tác commit + push như git. + Được biên soạn bằng markdown như git. Ngoài ra cú pháp để nhúng các blocks thường sử dụng khá đơn giản. + Có nhiều dạng blocks hỗ trợ nhiều mục đích, ngoài ra có thể tích hợp với nhiều dịch vụ hiện đại khác như Github, Google sheet, Figma... + Giao diện sản phẩm khá thân thiện.

Sử dụng như thế nào ?

• Chỉ cần truy cập vào https://www.gitbook.com/ và có thể sử dụng email google để đăng ký. Free đối với người sử dụng đơn lẻ ( có giới hạn một vài chức năng trong customize giao diện sản phẩm, các integration và không thể sử dụng cơ chế role như tổ chức).
• Thao tác trực tiếp trên trang web. Cách deploy cũng khá đơn giản, ấn share và gitbook sẽ tạo một url để có thể truy cập dạng: username.gitbook.io/product-docs
• Demo: https://ndvkhang-sgt.gitbook.io/sgt-insert-code/ hoặc https://ndvkhang-sgt.gitbook.io/untitled/

Chi phí

Nhìn chung với SGT có thể sử dụng với hai mục đích: tạo Docs cho các sản phẩm riêng biệt hoặc sử dụng như một wiki của dự án. Gitbook có thực hiện thu phí trên từng thành viên trong một dự án gitbook (từ $6.7 đến $12.5/người/tháng) và miễn phí đối với cá nhân.