github-community-exchange.md•3.54 kB
Hướng dẫn chi tiết cách submit repository lên **GitHub Community Exchange** dựa trên tài liệu chính thức của GitHub[2][1][4]:
---
## 1. **Chuẩn bị repository của bạn**
- **Repository phải công khai** (public) và thuộc tài khoản cá nhân.
- Đảm bảo repo có:
- **README.md**: Giới thiệu chi tiết về dự án.
- **LICENSE**: Để người khác biết họ có thể sử dụng source code như thế nào.
- **Description**: Mô tả ngắn cho repo (cài đặt ở phần About trên GitHub).
- **LEARN.md** (nếu mục đích là "Learn"): Hướng dẫn từng bước xây dựng dự án, lý tưởng nhất là giải thích từng phần nhỏ, kèm hình ảnh, code, media...
- **CONTRIBUTING.md** (nếu mục đích là "Collaborate"): Hướng dẫn cách đóng góp.
- **One or more issues** (nếu "Collaborate"): Tạo sẵn issue để cộng tác viên biết nên làm gì.
---
## 2. **Truy cập GitHub Community Exchange**
- Vào [GitHub Education Dashboard](https://education.github.com/dashboard) (cần đăng nhập GitHub).
- Trên dashboard, tìm mục **GitHub Community Exchange** hoặc truy cập trực tiếp [tại đây](https://education.github.com/community/exchange).
---
## 3. **Submit repository**
- Ở trang Community Exchange, phía trên danh sách repo, nhấn **Add repository**.
- Trong cửa sổ pop-up:
- **What is the purpose of your submission?**
Chọn mục đích repo:
- `Learn` (chia sẻ hướng dẫn, tài liệu học tập)
- `Collaborate` (tìm cộng tác viên)
- Hoặc cả hai
- **Which repository would you like to use?**
Chọn repo muốn submit từ danh sách repo cá nhân.
- Nếu repo chưa đủ điều kiện, hệ thống sẽ báo thiếu gì (README, LICENSE, LEARN.md, CONTRIBUTING.md, issues...).
- Có thể nhấn "Edit your repository" để bổ sung.
- **Which offers did you use for your project?**
(Tùy chọn, chọn các offer trong GitHub Student Developer Pack nếu có dùng)
- Nhấn **Submit the project**.
---
## 4. **Sau khi submit**
- Repo sẽ xuất hiện ngay trên Community Exchange với các thông tin bạn đã điền.
- Bạn có thể chỉnh sửa mục đích, topic, offer hoặc xóa submission bất cứ lúc nào từ tab **Submissions** trên trang Community Exchange[1].
- Mọi submission đều được cộng đồng kiểm duyệt.
---
## 5. **Tips để repo nổi bật hơn**
- Gắn thêm **topics** liên quan (ví dụ: `mcp`, `ai-agent`, `atlassian`, `jira`, `confluence`, `education`, v.v.).
- Đảm bảo README.md và LEARN.md (nếu có) thật chi tiết, dễ hiểu, nhiều ví dụ minh họa.
- Nếu repo hướng dẫn học tập, LEARN.md nên giải thích từng bước xây dựng dự án.
- Nếu repo tìm cộng tác viên, tạo sẵn issues và CONTRIBUTING.md rõ ràng.
---
**Nguồn tham khảo:**
- [Submitting your repository to GitHub Community Exchange][2]
- [Managing your submissions to GitHub Community Exchange][1]
- [Contribute with GitHub Community Exchange][4]
---[1]: https://docs.github.com/en/education/contribute-with-github-community-exchange/managing-your-submissions-to-github-community-exchange[2]: https://docs.github.com/en/education/contribute-with-github-community-exchange/submitting-your-repository-to-github-community-exchange[4]: https://docs.github.com/en/education/contribute-with-github-community-exchange