Chuyển tới nội dung chính

Tài liệu dự án

Cách lập tài liệu cho một dự án để người khác có thể hiểu, tái lập và tiếp tục phát triển nó.

Một trang dự án tốt bao gồm

  1. Mục tiêu — bài toán và mục tiêu cần đạt
  2. Đội ngũ & vai trò
  3. Kiến trúc hệ thống — sơ đồ khối phần cứng + phần mềm
  4. Danh mục vật tư (Bill of materials) — phần cứng/linh kiện chính
  5. Hướng dẫn thiết lập & build
  6. Kết quả — số liệu đo, hình ảnh, video/demo
  7. Liên kết — GitHub, bài báo, demo
  8. Bước tiếp theo / các vấn đề đã biết

Mẫu (Template)

Sao chép cấu trúc này vào một file mới trong dự án của bạn và điền nội dung vào. Đặt sơ đồ và hình ảnh gần phần liên quan. Các dự án công khai được giới thiệu trên trang Dự án.