DOL EduDoc Member Quick Start Slide Source

Purpose

Tạo một slide deck bằng tiếng Việt để hướng dẫn member mới:

1. hiểu repo này dùng để làm gì,
2. lấy repo về máy,
3. nhờ AI hướng dẫn setup repo trên máy một cách hợp lý,
4. dùng repo hiệu quả để đọc tài liệu, hiểu logic, và phát triển sản phẩm,
5. chỉ khi cần mới sang Playground để lên idea UI.

Audience

• Member mới của team
• Contributor không chuyên kỹ thuật
• Contributor có dùng AI để làm việc với repo
• Người cần một bức tranh nhanh trước khi bắt đầu dùng DOL EduDoc

Tone and visual direction

• Phong cách: dễ thương, đơn giản, sáng sủa, thân thiện
• Cảm giác: nhẹ nhàng, dễ hiểu, không quá technical, không quá corporate khô cứng
• Visual cues gợi ý:
  • màu sáng, pastel nhẹ, có điểm nhấn xanh dương hoặc xanh lá dịu
  • icon đơn giản, bo tròn, card rõ ràng
  • mỗi slide chỉ có 1 ý chính và 3-5 bullet mạnh
  • dùng sơ đồ đơn giản thay vì nhồi quá nhiều text
• Tránh:
  • quá nhiều jargon
  • quá nhiều command trên cùng một slide
  • biến deck thành tài liệu policy dày đặc

Core message

• EduDoc là nơi bắt đầu.
• AI nên đọc hướng dẫn trước khi trả lời.
• Repo này có thể dùng độc lập để đọc và phát triển tài liệu.
• Playground là bước sau, dùng để explore UI khi logic đã rõ.
• Nếu UI exploration làm đổi logic quan trọng, quay lại cập nhật EduDoc.

Slide outline

Slide 1 - Cover

Title: Bắt đầu với DOL EduDoc Subtitle: Từ lấy repo về máy, setup cùng AI, đến phát triển tài liệu và lên idea UI Key feel:

• chào đón member mới
• nhấn mạnh rằng đây là cách bắt đầu nhanh, không phải policy nặng

Slide 2 - Repo này dùng để làm gì?

Main message:

• Đây là repo tài liệu gốc để team đọc, thảo luận, phát triển logic sản phẩm và cập nhật tài liệu chung.
• Nếu chỉ cần docs và logic, bạn có thể dùng repo này mà không cần Playground.
• Đây là điểm bắt đầu tốt nhất trước khi explore UI.

Slide 3 - Bắt đầu từ đâu?

Main message:

• Không cần đọc cả repo ngay.
• Bắt đầu bằng 3 file chính:
  • README.md
  • QUICK_GUIDES.md
  • START_HERE.md
• Nếu chỉ muốn dùng nhanh, đọc QUICK_GUIDES trước.
• Nếu chưa biết mình đang làm việc theo hướng nào, đọc START_HERE.

Slide 4 - Bước 1: Lấy repo về máy

Main message:

• Clone repo về máy.
• Mở đúng folder repo trong Codex, Antigravity, hoặc editor bạn đang dùng.
• Không cần setup toàn bộ trước khi hiểu repo. Suggested command:
• git clone
• cd

Slide 5 - Bước 2: Nhờ AI đọc hướng dẫn trước

Main message:

• Việc đầu tiên không phải là code.
• Việc đầu tiên là nhờ AI đọc các file hướng dẫn chính. Suggested prompt:
• Hãy đọc README.md, QUICK_GUIDES.md, START_HERE.md trước và nói tôi nên bắt đầu từ đâu. Outcome:
• AI có context cơ bản
• AI có thể route bạn đúng file và đúng flow

Slide 6 - Bước 3: Hỏi AI cách setup hợp lý trên máy của bạn

Main message:

• Không cần tự đoán phải cài gì.
• Hãy để AI nhìn repo và đề xuất setup tối thiểu theo đúng nhu cầu của bạn. Suggested prompt:
• Dựa trên repo hiện tại, hãy hướng dẫn tôi cách cài đặt tối thiểu trên máy để dùng repo này hợp lý. Chỉ đưa những bước thật sự cần. Principle:
• setup vừa đủ
• không setup thừa

Slide 7 - Bước 4: Dùng repo để đọc và hiểu logic sản phẩm

Main message:

• Sau khi AI có context, bạn có thể dùng repo để hỏi logic hiện tại của feature.
• Nên hỏi theo flow:
  • logic hiện tại là gì?
  • file nào là file canonical?
  • còn thiếu edge case nào? Suggested prompts:
• Hãy tóm tắt logic hiện tại của feature này cho tôi.
• Hãy chỉ ra file canonical tôi nên đọc tiếp.
• Feature này còn thiếu trường hợp nào chưa được xử lý rõ?

Slide 8 - Bước 5: Dùng repo để cập nhật tài liệu gốc

Main message:

• Khi muốn bổ sung hoặc sửa logic, nhờ AI tìm đúng file canonical rồi cập nhật gọn vào đó.
• Không nên tạo thêm tài liệu mới nếu chỉ là thông tin có thể gộp vào file đang có.
• Ưu tiên giữ tài liệu gốc sạch, rõ, không để lại phần cũ lỗi thời. Suggested prompt:
• Giúp tôi tìm đúng file canonical cần sửa cho thay đổi này, rồi cập nhật nội dung ngắn, rõ, và không để lại phần cũ đã lỗi thời.

Slide 9 - Cách làm việc hiệu quả với AI

Main message:

• Cho AI đọc file hướng dẫn trước.
• Hỏi theo feature hoặc theo vấn đề cụ thể.
• Yêu cầu AI chỉ rõ file nguồn.
• Nếu muốn AI sửa docs, yêu cầu nó giữ scope nhỏ và update đúng file gốc. Simple checklist:
• Đọc đúng file trước
• Hỏi đúng vấn đề
• Sửa đúng file canonical
• Review trước khi ship

Slide 10 - Khi nào nên sang Playground?

Main message:

• Chỉ sang Playground khi logic đã tương đối rõ.
• Playground không bắt buộc.
• Nếu chỉ cần docs và logic, bạn có thể dừng ở EduDoc.
• Sang Playground khi muốn:
  • explore UI
  • thử nhiều version giao diện
  • trực quan hóa flow

Slide 11 - Dùng Playground để lên idea UI

Main message:

• Playground là nơi thử UI nhanh hơn, không phải nơi thay thế tài liệu gốc.
• Có thể dùng shared playground hoặc repo riêng.
• Nếu UI exploration làm đổi logic quan trọng, cập nhật ngược lại EduDoc. Simple rule:
• Docs first
• UI later
• Sync back nếu logic đổi

Slide 12 - 5 câu hỏi mẫu member có thể hỏi AI

Examples:

• Repo này dùng để làm gì và tôi nên bắt đầu từ file nào?
• Tôi cần setup gì tối thiểu để dùng repo này trên máy?
• Hãy đọc các tài liệu liên quan đến feature X và giải thích logic hiện tại cho tôi.
• Hãy giúp tôi cập nhật thay đổi này vào tài liệu gốc theo cách gọn và rõ.
• Tôi muốn dùng logic này để explore UI, bây giờ đã nên sang Playground chưa?

Slide 13 - Closing

Main message:

• Đừng cố hiểu cả repo trong một lần.
• Bắt đầu từ entry docs.
• Dùng AI như người hướng dẫn.
• Chốt logic ở EduDoc trước.
• Chỉ sang UI exploration khi đã đúng thời điểm. Final line:
• Hiểu repo trước, setup vừa đủ, dùng AI đúng cách, rồi mới đi xa.

Extra speaker notes guidance

• Giữ ngôn ngữ nói chuyện tự nhiên, gần gũi.
• Mỗi slide nên giải thích trong 20-40 giây.
• Ưu tiên ví dụ ngắn, sát công việc thật của member.
• Nếu có chỗ cần so sánh, dùng bảng 2 cột hoặc card so sánh đơn giản.

Important constraints

• Toàn bộ deck phải bằng tiếng Việt.
• Phải dễ hiểu với cả người không quá technical.
• Không biến slide thành checklist nặng nề.
• Phải giữ được cảm giác dễ thương, thân thiện, nhưng vẫn gọn và chuyên nghiệp.