Hướng dẫn đóng góp

Cảm ơn bạn đã muốn đóng góp cho Học AI Việt! Repo này được viết để phục vụ cộng đồng, nên bất kỳ ai cũng có thể sửa - kể cả khi đây là lần đầu tiên bạn dùng GitHub. Dưới đây là hướng dẫn cho cả người mới lẫn người quen Git.

Bạn có thể đóng góp gì?

• Sửa lỗi sai, lỗi chính tả - dù nhỏ cũng quý.
• Cập nhật giá cả - giá API, giá GPU, giá VPS thay đổi liên tục. Thấy số cũ, sửa luôn.
• Cập nhật thông tin model mới - ngành AI ra model mới mỗi vài tháng, nội dung cũ cần người giữ cho tươi.
• Thêm case study - bạn build được sản phẩm gì bằng AI? Chia sẻ vào 07-case-study/, kèm chi phí thật và bài học rút ra.
• Viết thêm bài mới - nếu thấy thiếu chủ đề, mở issue đề xuất trước khi viết để tránh trùng công sức với người khác.
• Dịch thuật ngữ cho dễ hiểu hơn - nếu bạn có cách giải thích một khái niệm dễ hiểu hơn bản hiện tại, cứ đề xuất.

Đóng góp mảng mới (media, AI tạo sinh ảnh/video/âm thanh...)

Nội dung chính của repo tập trung vào nhánh code - dùng AI để build sản phẩm phần mềm. Mảng media (AI tạo ảnh, video, âm thanh, giọng nói...) hiện để mở cho cộng đồng đóng góp thành một phần mới, không phải nhồi rải rác vào các phần đã có. Nếu bạn muốn mở mảng này:

1. Mở issue đề xuất trước khi viết, để bàn cấu trúc và tránh trùng công sức với người khác đang làm cùng ý tưởng.
2. Tạo một thư mục cấp cao mới theo đúng mẫu cấu trúc sẵn có: một file README.md giới thiệu phần đó + tóm tắt các bài, và các bài học đánh số NN-ten-khong-dau.md - xem cách một phần hiện có tổ chức, ví dụ 04-build-ung-dung-ai/. Đặt tên thư mục theo đúng số thứ tự tiếp theo còn trống ở gốc repo - ví dụ tại thời điểm viết dòng này, số tiếp theo là 12-ten-mang-moi/ (tự kiểm tra lại số hiện có trước khi đặt tên, vì lúc bạn đọc dòng này có thể đã có phần khác chiếm số đó).
3. Áp dụng đúng mọi quy tắc nội dung ở mục dưới đây (giọng "bạn - mình", thực chiến, có bảng giá thật ước tính bằng VND kèm "giá có thể thay đổi, kiểm tra trang chủ", không giật tít/FOMO) - và thêm hai điều riêng cho mảng media vì rủi ro quảng cáo trá hình ở đây cao hơn nhánh code: không gắn link affiliate, và không dùng bài viết để quảng cáo trá hình cho khóa học trả phí (của chính bạn hay bên thứ ba). Nhắc tới một công cụ/khóa học trả phí chỉ khi nội dung thực sự đáng nhắc, không phải vì có hoa hồng.

Cách 1: Sửa trực tiếp trên GitHub (không cần cài gì cả)

Đây là cách nhanh nhất nếu bạn chỉ sửa vài dòng và chưa quen dùng Git:

1. Mở file bạn muốn sửa trên GitHub, bấm vào biểu tượng cây bút (Edit this file) ở góc trên bên phải.
2. Sửa nội dung ngay trên trình duyệt.
3. Cuộn xuống dưới, viết một dòng mô tả ngắn bạn đã sửa gì (ví dụ: "Cập nhật giá VPS Vietnix tháng 9/2026").
4. Chọn "Create a new branch and start a pull request", bấm Propose changes.
5. Xong - vậy là bạn vừa tạo Pull Request (PR) đầu tiên rồi. Đội duy trì repo sẽ xem và phản hồi.

Cách 2: Fork + clone (cho thay đổi lớn hơn, nhiều file)

Nếu bạn chưa quen các bước dưới đây, tham khảo 02-code-voi-ai/05-git-github-co-ban.md trước.

git clone https://github.com/<ten-cua-ban>/hoc-ai.git
cd hoc-ai
git checkout -b sua-loi-gia-vps

• Dòng 1: tải repo (bản bạn đã fork) về máy.
• Dòng 2: vào thư mục vừa tải.
• Dòng 3: tạo một nhánh (branch) riêng để làm việc, đặt tên ngắn gọn mô tả bạn đang làm gì.

Sửa file, sau đó:

git add .
git commit -m "Cập nhật giá VPS Vietnix tháng 9/2026"
git push origin sua-loi-gia-vps

• git add .: đánh dấu tất cả file đã sửa để chuẩn bị lưu.
• git commit -m "...": lưu lại thay đổi kèm mô tả.
• git push origin ...: đẩy nhánh của bạn lên GitHub.

Sau đó vào GitHub, bấm Compare & pull request để mở PR.

Quy tắc nội dung (đọc trước khi viết bài mới)

• Giọng văn "bạn - mình", thân thiện, thực chiến - như đang giải thích cho một người bạn chưa biết gì.
• Không giật tít, không tạo FOMO. Tránh kiểu "thời đại đã chấm dứt", "không học AI là tụt hậu"... - nội dung thuyết phục bằng chất lượng, không bằng cảm giác sợ bị bỏ lỡ.
• AI là con dao, chuyên môn là đầu bếp. Khi viết bài mới, ưu tiên gắn kỹ năng AI vào một việc/lĩnh vực cụ thể của người đọc, không dạy "AI" như một môn học trừu tượng tách rời thực tế.
• Trung lập, không quảng cáo trá hình. Ưu tiên giới thiệu công cụ miễn phí/open source trước, công cụ trả phí chỉ nêu khi thực sự cần thiết hoặc tốt hơn hẳn.
• Luôn có bảng giá VND ước tính khi nhắc tới dịch vụ trả phí, kèm ghi chú "giá có thể thay đổi, kiểm tra trang chủ để có giá mới nhất". Đừng bịa số chính xác nếu không chắc.
• Lệnh terminal phải để trong code block, và giải thích từng dòng lệnh ngay bên dưới - người đọc có thể chưa từng mở terminal bao giờ.
• Mỗi file nên mở đầu bằng 1-2 câu nói file này dành cho ai, học xong làm được gì, và kết thúc bằng mục "Bước tiếp theo" link sang bài kế tiếp trong lộ trình.
• Không copy nguyên văn từ nguồn khác - viết lại bằng hiểu biết và văn phong của bạn, có thể dẫn nguồn nếu tham khảo.

Báo lỗi / đề xuất ý tưởng (Issue)

Không muốn tự sửa nhưng thấy vấn đề? Vào tab Issues trên trang GitHub của repo, bấm New issue, chọn form "Góp ý / báo lỗi nội dung" - form có sẵn các câu hỏi (loại góp ý, bài nào, mô tả cụ thể), không cần tự nghĩ cách trình bày.

Chưa có tài khoản GitHub? Gửi email trực tiếp tới thunguyen@startee.vn, ghi rõ: bài nào (link hoặc tên file), bạn thấy gì chưa đúng/chưa rõ, và mong đợi thấy gì thay vào đó - đúng những câu hỏi trong form Issue ở trên. Đây là kênh dành cho người không quen GitHub, không phải kênh hỗ trợ nhanh - phản hồi có thể mất vài ngày.

Quy tắc ứng xử

Đây là không gian học tập mở cho người mới. Luôn tôn trọng, kiên nhẫn, không chê bai câu hỏi "ngớ ngẩn" - ai cũng từng không biết gì trước khi biết.