Chính thức ra mắt Sun* Technical Documentation Hub: Kết nối sức mạnh tri thức Việt - Nhật
Hôm nay, Sun* chính thức ra mắt Sun* Technical Documentation Hub – một nền tảng tài liệu kỹ thuật toàn diện, tập hợp và tổ chức tất cả các tài liệu kỹ thuật mà Sun* đã, đang và sẽ phát triển. Đây là thành quả của sự hợp tác và nỗ lực không ngừng nghỉ từ đội ngũ phát triển tại Việt Nam và Nhật Bản, nhằm giải quyết thách thức lớn về việc chia sẻ kiến thức chung.
Tại sao lại cần có Technical Documentation Hub?
Trước đây, việc chia sẻ kiến thức kỹ thuật và các ý tưởng, bài học kinh nghiệm hay đúc rút từ dự án Sun* Việt Nam và Nhật Bản diễn ra một cách độc lập và riêng lẻ, dẫn đến sự thiếu hụt một nền tảng chung để tiếp cận thông tin toàn diện. Sự thiếu kết nối này gây lãng phí thời gian và công sức tìm kiếm, đồng thời cản trở việc học hỏi kinh nghiệm lẫn nhau giữa hai văn phòng.
Chính thách thức này đã thúc đẩy sự ra đời của Sun* Technical Documentation Hub - ý tưởng định hình trở thành “thư viện tổng hợp” để gom tất cả về một mối và lưu giữ, cập nhật toàn bộ nội dung hay từ kho tàng tri thức 2 bên.

Dự án Sun* Technical Documentation Hub được khởi động vào cuối tháng 8 và đã nhanh chóng đi vào hoạt động với sự tham gia của 4 thành viên, bao gồm 3 chuyên gia từ Sun* Việt Nam và 1 đại diện đến từ Sun* Nhật Bản. Mục tiêu cuối cùng của thư viện này là giúp mọi lập trình viên tại Sun* có thể truy cập kiến thức, đề xuất và triển khai các giải pháp tối ưu cho dự án của mình dựa trên những kinh nghiệm thực tế sẵn có.
"Mục tiêu cuối cùng của Hub là hoạt động như một thư viện chia sẻ kiến thức giữa Sun* Việt Nam và Sun* Nhật Bản. Bất kỳ chuyên gia kỹ thuật nào tại Sun* đều có thể truy cập, tìm kiếm và đóng góp để triển khai các giải pháp tối ưu cho các dự án” - anh Daiki Miura, thành viên dự án từ Sun* Japan chia sẻ.

Điểm đặc biệt nhất của Sun* Technical Documentation Hub
Thử thách lớn nhất trong quá trình xây dựng Sun* Technical Documentation Hub là khó khăn trong quá trình đồng bộ, tích hợp tài liệu đang có. Các tài liệu kỹ thuật của toàn công ty ở cả hai văn phòng Việt - Nhật được quản lý trong các kho lưu trữ (repositories) riêng biệt, độc lập, mỗi tài liệu một nơi và phân quyền khác nhau. Nếu đưa hết về một nguồn thì sẽ gặp phải rất nhiều khó khăn trong công tác tổng hợp và vận hành quản lý.
Giải pháp được đội ngũ lựa chọn là sử dụng Git Submodules để tích hợp các kho lưu trữ hiện có vào Hub. Điều này cho phép duy trì việc quản lý nơi lưu trữ riêng biệt của từng tài liệu, đồng thời vẫn tạo được một thư viện mở Tech Docs Hub nơi mọi người có thể tìm được mọi thứ mình cần.
Các Tính năng nổi bật
Được xây dựng trên nền tảng Docusaurus mạnh mẽ, thư viện tổng hợp này sẽ là “kho tàng” để các lập trình viên tìm kiếm tài liệu hay với những tính năng tiện dụng:
Tìm kiếm tập trung | Tìm thông tin nhanh chóng trong toàn bộ tài liệu từ một vị trí duy nhất. |
Hỗ trợ đa ngôn ngữ | Hỗ trợ Tiếng Anh, Tiếng Việt và Tiếng Nhật. Dễ dàng chuyển đổi ngôn ngữ thông qua các tệp Markdown riêng biệt. |
Quản lý tập trung | Quản lý nhiều tài liệu kỹ thuật trên một nền tảng duy nhất, đồng thời duy trì độc lập mỗi tài liệu như các kho lưu trữ riêng biệt qua Git Submodules. |
Cập nhật dễ dàng | Hỗ trợ cập nhật tài liệu từ nguồn gốc một cách nhanh chóng (chạy git submodule update --remote). |
Cấu trúc trực quan | Cấu trúc 5 danh mục trực quan dựa trên vòng đời phát triển (thiết kế → triển khai → kiểm thử → vận hành). |
Tự động hóa | Tự động hóa và DevOps hoàn toàn: Triển khai tự động lên GitHub Pages ngay khi đẩy (push) lên nhánh chính. |
Giao diện & Hiệu năng | Thiết kế đồng nhất, thân thiện với người dùng và được tối ưu cho tốc độ tải nhanh, mượt mà. |

Lộ trình triển khai
Ở giai đoạn ra mắt, thư viện còn sơ khai và sẽ dần đồng bộ, bổ sung các tài liệu trong thời gian tới. Những tài liệu quan trọng đã được đồng bộ lên có thể kể đến như:
- Sách trắng Công nghệ Sun* Tech White Paper
- Tài liệu kiểm thử Sun* Playwright Testing Documentation
- Hướng dẫn Sun* Copilot Handbook
- Tiêu chuẩn source code Sun* Coding Standards
- Hướng dẫn lập trình an toàn Sun* Secure Coding Guideline
Ý tưởng về một thư viện tổng hợp tri thức là một khởi đầu tuyệt vời, nhưng để nó thực sự trở thành “bộ não kỹ thuật” của Sun* vẫn là một hành trình dài đòi hỏi sự đóng góp của tất cả Sunner. Ngay từ thời điểm này, đội ngũ phát triển đã chính thức kêu gọi tất cả Sunner cùng tham gia viết tài liệu, khiến thư viện ngày càng nhiều “đầu sách” quý hơn.
Đừng ngần ngại chia sẻ kiến thức của bạn. Sun* Technical Documentation Hub chính là không gian để tiếng nói chuyên môn của bạn được lắng nghe và lan tỏa!
Cách Thức Đóng Góp Đơn Giản
|


Thư viện này chỉ trở nên phong phú và hữu ích khi mỗi thành viên chủ động biến kinh nghiệm cá nhân thành tài sản tập thể. Trong tương lai, thư viện sẽ được định hướng trở thành môi trường đóng góp mở với các danh mục "Official" (tài liệu chính thức) và "Draft" (không gian đóng góp ít rào cản, không yêu cầu xem xét). Đội ngũ cũng đang ấp ủ việc tận dụng nền tảng kiến thức Markdown này với AI để cung cấp các giải pháp chuyên biệt cho từng dự án cụ thể trong tương lai.
Sự ra đời của Sun* Technical Documentation Hub không chỉ đơn thuần là một thư viện tổng hợp. Đây chính là những bước đi đầu tiên của toàn Sun* trên hành trình đồng bộ, đúc rút tri thức từ kinh nghiệm "chinh chiến" thực tế và phát huy tối đa sức mạnh tập thể ở quy mô toàn cầu.
Hub minh chứng cho khát vọng "học tập suốt đời" của mỗi người Sun* và là nỗ lực liên tục thúc đẩy, “thách thức” nhau để nâng cao chuyên môn, không ngừng phát triển và cùng nhau đạt đến những chuẩn mực kỹ thuật awesome nhất. Tại Sun*, tri thức được trân trọng, được chia sẻ một cách cởi mở, và được xây dựng bởi chính đội ngũ của chúng ta. Hãy cùng nhau khai phá và phát huy sức mạnh tri thức tập thể này!
Cần hỗ trợ? Nếu gặp khó khăn khi sử dụng Hub, vui lòng tìm kiếm hỗ trợ tại kênh Slack: #con_tech_docs_hub. |


