(Tôi đã gửi bài này cho danh sách đăng ký một thời gian trước. Nếu bạn thích và muốn đọc thêm, hãy đăng ký!)
Hệ sinh thái Rails di chuyển nhanh, nhanh đến mức sách in kịp. Nếu bạn như tôi, bạn muốn học phiên bản mới nhất của framework và gem. Nhưng những tài nguyên tốt nhất thường lại lạc hậu vài phiên bản.
Những tài nguyên này vẫn hữu ích. Không có gì bằng một cuốn sách, screencast, hoặc hướng dẫn được biên tập tốt để học API, triết lý và cấu trúc của một thư viện.
Ví dụ, nếu sách Rails hay nhất chỉ mô tả Rails 4.0, bạn vẫn nên bắt đầu từ đó. Khi học gem hoặc framework mới, quan trọng là hiểu tại sao nó được thiết kế theo cách đó và cách các mảnh ghép khớp nhau. Điều đó khó có được từ tài liệu tham khảo và bài blog, nhưng dễ dàng từ sách.
Nhưng sau khi có kinh nghiệm với phiên bản cũ của gem, làm sao để bắt kịp?
Bắt kịp những thay đổi
Hầu hết gem phổ biến đều có file CHANGELOG trong repo git, ví dụ bundler: https://github.com/bundler/bundler/blob/master/CHANGELOG.md. Đây là cách tuyệt vời để nắm bắt những thay đổi lớn từ phiên bản này sang phiên bản khác. Thường chỉ là tóm tắt ngắn gọn mỗi thay đổi chính. Nhưng chúng cho bạn điểm khởi đầu để nghiên cứu sâu hơn về những thay đổi thú vị.
Nhiều changelog tham chiếu đến số bug trên GitHub. Nếu bạn thấy entry trong changelog có số bug, bạn có thể tìm bug đó trong Issues của project để hiểu gì đã thay đổi, cách nó thay đổi, và tại sao thay đổi.
Vậy làm sao tìm changelog? Thường tôi chỉ search google bundler github (nếu tìm changelog bundler), và chúng thường ở trang GitHub đầu tiên bạn thấy.
Nếu không có changelog, bạn cũng có thể xem README hoặc wiki của project trên GitHub. Nhưng vì chúng không được thiết kế để giúp bạn bắt kịp từ phiên bản này sang phiên bản khác, thường mất nhiều thời gian hơn.
Sử dụng tài liệu tham khảo cập nhật
Khi làm việc với gem, bạn cũng cần tài liệu tham khảo cập nhật. Để tra cứu cách dùng API và xem ví dụ khi viết app của mình.
Bạn có thể tìm tài liệu API cho bất kỳ phiên bản nào của bất kỳ gem nào tại rdoc.info. Nhưng để tra cứu doc nhanh hơn, bạn nên xem Dash hoặc Zeal.
Tôi dùng Dash, nên khi cần tra API doc, tôi bấm option-Space, gõ chữ, và tất cả gem documentation hiện ra ngay lập tức. Thay đổi workflow này đã hoàn vốn nhiều lần.
Một vài mẹo riêng cho Rails
Rails là dự án lớn, và người đóng góp Rails làm rất tốt việc maintain changelog và documentation.
Rails Guides rất tốt, và chúng được build từ cùng repo git với Rails, nên luôn cập nhật.
Nếu bạn muốn bắt kịp phiên bản Rails mới nhất, release notes là nơi tốt nhất để bắt đầu. Ví dụ, release notes Rails 4.1: https://guides.rubyonrails.org/4_1_release_notes.html
Quy trình tôi thường làm
Tổng hợp lại, đây là những gì tôi làm khi muốn hoàn toàn cập nhật về thư viện mới:
- Đọc sách, tutorial, hoặc tài liệu về gem. Tôi thường tìm tài nguyên mới nhất có thể. Khi đọc, tôi build app, thực hành, v.v. trên phiên bản tôi đang học.
- Tìm project trên GitHub.
- Đọc changelog, readme, hoặc wiki của project để đưa tôi từ phiên bản tôi biết đến phiên bản mới nhất.
- Nếu quan tâm đến thay đổi cụ thể, google حولها hoặc xem qua issues của project để hiểu thêm.
- Nâng cấp lên phiên bản mới nhất của gem.
- Cài đặt doc của gem mới vào Dash.
- Viết code với nó!
Tôi không làm tất cả các bước mọi lúc. Nhưng đó là thứ tự chung, và quy trình kiểu này hữu ích để giữ lại phòng khi mắc kẹt ở một bước hoặc không biết đi đâu tiếp theo.
Nếu không tìm thấy changelog hoặc không hiểu docs thì sao?
Đôi khi bạn chỉ không thể lấy thông tin cần thiết từ repo GitHub hoặc API documentation của gem. Khi đó, bạn phải đi sâu vào code và bắt đầu đọc nó.
Ngạc nhiên thay, đọc code không giống đọc sách. Thay vì đọc file từ đầu đến cuối, bạn phải khám phá code. Đây là nghệ thuật hơn là khoa học, nhưng là kỹ năng quan trọng cần học. Vì vậy, tôi có thể sẽ nói thêm về nó sau!
Bạn có gì tips để bắt kịp thay đổi gem? Làm sao bạn giữ cập nhật?