Computer >> Máy Tính >  >> Lập trình >> Ruby

Hướng dẫn học từ các tài nguyên lỗi thời

(Tôi đã gửi bài đăng này vào danh sách của mình một thời gian trước. Nếu bạn thích nó và muốn đọc nhiều hơn giống như nó, bạn nên đăng ký!)

Hệ sinh thái Rails di chuyển nhanh, quá nhanh đối với bản in. Nếu bạn giống tôi, bạn muốn tìm hiểu phiên bản mới nhất của các khuôn khổ và đá quý của mình. Nhưng các tài nguyên tốt nhất thường có một vài phiên bản sau.

Tuy nhiên, những tài nguyên này vẫn hữu ích. Không có gì giống như một cuốn sách được biên tập tốt, chương trình truyền hình hoặc hướng dẫn để tìm hiểu API, triết lý và cấu trúc của thư viện.

Ví dụ, nếu các sách Rails tốt nhất chỉ mô tả Rails 4.0, bạn vẫn nên bắt đầu từ đó. Khi bạn đang tìm hiểu một viên ngọc hoặc khuôn khổ mới, điều quan trọng là phải tìm hiểu tại sao nó được thiết kế theo một cách nhất định và cách tất cả các phần khớp với nhau. Điều đó khó lấy từ tài liệu tham khảo và các bài đăng trên blog, nhưng dễ lấy từ sách.

Nhưng sau khi bạn xây dựng trải nghiệm với phiên bản đá quý cũ hơn, làm thế nào để bạn bắt kịp?

Bắt kịp các thay đổi

Hầu hết các đá quý phổ biến đều có tệp CHANGELOG trong kho lưu trữ git của chúng, chẳng hạn như Bundler:https://github.com/bundler/bundler/blob/master/CHANGELOG.md. Đây là một cách tuyệt vời để bắt kịp những thay đổi lớn từ phiên bản này sang phiên bản khác. Thông thường, chúng chỉ là một bản tóm tắt ngắn về từng thay đổi lớn. Nhưng chúng cung cấp cho bạn một điểm khởi đầu, vì vậy bạn có thể nghiên cứu thêm về những thay đổi thú vị.

Nhiều thay đổi tham chiếu số lỗi trên GitHub. Nếu bạn thấy một mục trong bảng thay đổi có đính kèm số lỗi, bạn có thể tìm lỗi trong mục Vấn đề của dự án để hiểu những gì đã thay đổi, cách nó thay đổi và tại sao nó lại thay đổi.

Vì vậy, làm thế nào để bạn tìm thấy các thay đổi? Thông thường, tôi chỉ tìm kiếm trên google cho bundler github (nếu tôi đang tìm kiếm bảng thay đổi gói) và chúng thường ở trên trang GitHub đầu tiên mà bạn nhìn thấy.

Nếu không có bảng thay đổi, bạn cũng có thể xem README của dự án hoặc wiki của dự án 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, nên chúng thường mất nhiều thời gian hơn để hoàn thành.

Sử dụng tài liệu tham khảo cập nhật

Khi làm việc với đá quý, bạn cũng cần cập nhật tài liệu tham khảo. Bằng cách đó, bạn có thể tra cứu việc sử dụng API và xem các ví dụ trong khi viết ứng dụng của riêng mình.

Bạn có thể tìm thấy tài liệu API cho bất kỳ phiên bản gem nào tại rdoc.info. Tuy nhiên, để tra cứu tài liệu nhanh hơn nữa, bạn nên xem Dấu gạch ngang hoặc Song kiếm.

Tôi sử dụng Dash, vì vậy khi tôi cần tra cứu tài liệu API, tôi nhấn option-Space, bắt đầu nhập và tất cả tài liệu gem của tôi sẽ hiển thị ngay lập tức. Đó là một sự thay đổi trong quy trình làm việc của tôi mà bản thân nó đã phải trả nhiều lần.

Một vài mẹo về Rails, cụ thể là

Rails là một dự án lớn và những người đóng góp cho Rails làm rất tốt việc duy trì các thay đổi và tài liệu.

Hướng dẫn đường ray rất tốt và chúng cũng được xây dựng từ cùng một kho lưu trữ git như Rails, vì vậy chúng luôn được cập nhật.

Nếu bạn đang cố gắng bắt kịp phiên bản Rails mới nhất, ghi chú phát hành là nơi tốt nhất để bắt đầu. Ví dụ:đây là các ghi chú phát hành cho Rails 4.1:https://guides.rubyonrails.org/4_1_release_notes.html

Quy trình tôi thường thực hiện

Tổng hợp tất cả lại với nhau, đây là điều tôi làm khi muốn cập nhật hoàn toàn thư viện mới:

  1. Đọc một cuốn sách, hướng dẫn hoặc tài liệu về đá quý. Tôi thường cố gắng tìm nguồn tài nguyên mới nhất mà tôi có thể. Trong khi đọc, tôi xây dựng ứng dụng, thực hành, v.v. trên bất kỳ phiên bản nào tôi đang học.
  2. Tìm dự án trên GitHub.
  3. Đọc thay đổi, readme hoặc wiki của dự án để đưa tôi từ phiên bản tôi biết sang phiên bản mới nhất.
  4. Nếu tôi quan tâm đến một thay đổi cụ thể, hãy tìm kiếm nó hoặc tìm hiểu các vấn đề của dự án để tìm hiểu thêm.
  5. Nâng cấp lên phiên bản đá quý mới nhất.
  6. Cài đặt tài liệu về đá quý mới trong Dash.
  7. Viết mã bằng nó!

Tôi không làm tất cả các bước đó mọi lúc. Nhưng nói chung đó là thứ tự tôi thực hiện và loại quy trình này rất hữu ích để duy trì trong trường hợp tôi bị mắc kẹt ở một bước hoặc không biết phải đi đâu tiếp theo.

Điều gì sẽ xảy ra nếu bạn không thể tìm thấy bảng thay đổi hoặc không thể hiểu được tài liệu?

Đôi khi bạn sẽ không thể nhận được thông tin mình cần từ kho GitHub hoặc tài liệu API của đá quý. Khi điều đó xảy ra, bạn sẽ phải đi sâu vào mã và bắt đầu đọc nó.

Đáng ngạc nhiên là đọc mã không giống như đọc sách. Thay vì đọc tệp từ đầu đến cuối, bạn phải khám phá mật mã. Đây là một nghệ thuật hơn là một khoa học, nhưng nó là một kỹ năng quan trọng để học. Vì vậy, tôi có thể sẽ nói thêm về điều đó sau!

Bạn đã học được những thủ thuật nào để nắm bắt được những thay đổi về đá quý? Làm thế nào để bạn luôn cập nhật?