Computer >> Hướng Dẫn Máy Tính >  >> Lập Trình >> Ruby

Tăng năng suất Rails: Ngăn câu hỏi làm gián đoạn luồng làm việc

Practicing Rails đã phát hành! Giảm 25% cho đến thứ Sáu, 13 tháng 2.

Khi viết code, câu hỏi liên tục nảy ra trong đầu: Làm sao gọi method này? Nó nhận option gì? Nếu truyền object thay vì number thì sao?

Những câu hỏi này giết chết năng suất. Khi không biết câu trả lời ngay, bạn quên việc đang làm. Bị kéo ra khỏi luồng (flow), và mất nửa giờ để quay lại.

Làm sao tìm câu trả lời cần thiết mà không chậm chạp?

Tra cứu nhanh

Tốc độ là chìa khóa khi tra tài liệu API. Bạn muốn lấy câu trả lời và quay lại code càng nhanh càng tốt. Nếu không, rất dễ bị lệch hướng. Tôi không đếm được bao nhiêu lần cần tham số method mà cuối cùng lướt tin nhắn xấu xí trên reddit một tiếng.

Để tra tài liệu nhanh, bạn cần Dash (Mac) hoặc Zeal (các nền tảng khác). Với công cụ này, chỉ cần bấm hai phím để mở tài liệu cần thiết mà không cần suy nghĩ.

Nhưng cần chút thiết lập ban đầu.

Sau khi tải app, hãy làm hai việc:

  1. Tải docset cho các thư viện bạn dùng.

    Tôi tải doc cho Ruby, Rails, CSS, HTML, JavaScript, và thôi. Nếu dùng gem phức tạp thường xuyên như Nokogiri, tải thêm doc của nó. Đừng tải quá nhiều – nếu doc quá nhiều, bạn sẽ chậm lại khi phân vân method concat nào mới là cái bạn cần.

  2. Thiết lập Global Search Shortcut. Trên Mac tôi thường dùng Option-Space.

    Điều này biến Dash từ "chỉ là trang doc khác" thành công cụ tuyệt đối cần thiết. Khi đã thiết lập phím tắt toàn cục, bạn bấm Option-Space, gõ tìm kiếm, thấy doc cần thiết, bấm Option-Space nữa, và có câu trả lời mà không nhận ra mình vừa làm gì. Bạn trả lời câu hỏi API trước khi nhận ra mình có câu hỏi đó.

Chi tiết, câu hỏi, và bình luận

Thật đáng tiếc, đôi khi API docs không có đủ chi tiết bạn muốn. Hoặc bạn cần hiểu bên trong một tính năng.

Bạn phải hy sinh tốc độ để trả lời những câu hỏi này. Nhưng có trang tài liệu thay thế tốc độ bằng chi tiết và cộng đồng.

APIDock

APIDock chỉ bao gồm Ruby, Rails, và RSpec. Nhưng vẫn rất hữu ích:

  • APIDock cho biết method Rails nào bị deprecated, và nên dùng gì thay thế. Theo dõi thay đổi giữa các version Rails về từ 1.0. Nếu làm việc với code Rails cũ, nó là tài nguyên tuyệt vời.

  • Nhiều method API có bình luận do lập trình viên Rails đóng góp. Những bình luận rất hay. Với APIDock, bạn sẽ biết trước các edge case và vấn đề thường gặp trước khi gặp phải.

Quy trình tra tài liệu mới của bạn

Làm sao kết hợp tất cả?

  1. Khi có câu hỏi về API, dùng phím tắt để nhanh chóng mở Dash hoặc Zeal.
  2. Nếu cần chi tiết hơn, lên web. Thử APIDock trước, đặc biệt nếu tìm API trong app Rails cũ.

Khi có thể tra tài liệu tức thì, năng suất Rails của bạn sẽ thay đổi. Bạn không chỉ tập trung hơn, còn học thêm về thư viện và framework bạn phụ thuộc.

Bạn không thể biết mọi thứ về mọi công cụ bạn dùng. Bạn sẽ luôn cần tài liệu ở mức độ nào đó. Vậy hãy dành chút thời gian giờ để tiết kiệm thời gian tra cứu sau này. Nó sẽ mang lại lợi ích khổng lồ suốt sự nghiệp lập trình của bạn.