Practice Rails đã ra mắt! Nhận nó với mức giảm giá 25% cho đến Thứ Sáu, ngày 13 tháng 2.
Trong khi bạn viết mã, các câu hỏi xuất hiện trong đầu bạn liên tục :Làm cách nào để gọi phương thức này? Nó có những lựa chọn nào? Điều gì xảy ra nếu tôi chuyển một đối tượng thay vì một số?
Những câu hỏi này phá hủy năng suất của bạn. Khi bạn không biết câu trả lời ngay lập tức, bạn sẽ quên mất mình đang làm gì. Bạn bị trật khỏi dòng chảy của mình và phải mất nửa giờ để quay lại nơi bạn đã dừng lại.
Vậy làm cách nào để bạn tìm thấy câu trả lời mình cần mà không bị chậm lại?
Tra cứu nhanh
Tốc độ là chìa khóa khi bạn tra cứu tài liệu API. Bạn muốn nhận được câu trả lời của mình và thoát ra càng nhanh càng tốt. Nếu không, quá dễ dàng để đi chệch hướng. Tôi không thể đếm được tần suất mình cần biết các tham số của một phương thức và bằng cách nào đó, tôi đã nhìn thấy những tin nhắn văn bản đáng xấu hổ trên reddit trong một giờ.
Để có tài liệu nhanh chóng, bạn sẽ muốn Dash, dành cho Mac hoặc Zeal cho mọi thứ khác. Với những công cụ này, bạn có thể nhấn hai phím trên bàn phím của mình và hiển thị tài liệu bạn cần mà không cần phải suy nghĩ về những gì bạn đang làm.
Nhưng trước tiên họ cần một chút thiết lập.
Sau khi bạn tải xuống một trong hai ứng dụng này, hãy thực hiện hai việc sau:
-
Tải xuống bộ tài liệu cho các thư viện bạn sử dụng.
Tôi lấy tài liệu về Ruby, Rails, CSS, HTML và Javascript, và đó là về nó. Nếu có một loại đá quý phức tạp mà bạn sử dụng nhiều, như Nokogiri, hãy lấy cả những tài liệu đó. Nhưng đừng đi quá đà - nếu bạn có quá nhiều tài liệu, bạn sẽ chậm lại khi cố gắng tìm ra tài liệu nào
concatphương pháp mà bạn thực sự muốn nói. -
Thiết lập Lối tắt tìm kiếm toàn cầu . Trên Mac, tôi thường sử dụng option-Space.
Đây là những gì biến Dash từ "chỉ là một trang web tài liệu khác" thành một công cụ hoàn toàn thiết yếu. Sau khi thiết lập phím tắt tìm kiếm chung, bạn có thể nhấn option-Space, bắt đầu nhập, xem tài liệu bạn cần, nhấn lại option-Space và có câu trả lời mà không cần biết bạn vừa làm gì. Bạn có thể trả lời các câu hỏi về API của mình trước khi biết rằng bạn đã có chúng.
Chi tiết, câu hỏi và nhận xét
Rất tiếc, đôi khi tài liệu API không có tất cả thông tin chi tiết bạn muốn biết. Hoặc bạn có thể cần biết cách một tính năng hoạt động bên trong.
Bạn sẽ phải hy sinh tốc độ để trả lời những câu hỏi này. Nhưng có một trang web 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 nó vẫn hữu ích:
-
APIDock sẽ cho bạn biết khi nào các phương thức Rails không được dùng nữa và những gì bạn nên sử dụng thay thế. Nó theo dõi các thay đổi phiên bản này sang phiên bản khác trong Rails từ phiên bản 1.0 trở về trước. Vì vậy, nếu bạn đang làm việc với mã Rails cũ, đó là một nguồn tài nguyên tuyệt vời.
-
Rất nhiều phương thức API có nhận xét do các nhà phát triển Rails đóng góp. Các ý kiến thực sự tốt. Với APIDock, bạn sẽ nghe về các trường hợp phức tạp và các sự cố thường gặp trước đây bạn tình cờ gặp chúng.
Quy trình làm tài liệu mới của bạn
Vậy, làm thế nào để bạn tổng hợp tất cả những điều này lại với nhau?
- Khi bạn có câu hỏi về API, hãy sử dụng phím nóng để hiển thị nhanh Dash hoặc Zeal.
- Nếu bạn cần thêm thông tin chi tiết, hãy truy cập trang web. Trước tiên, hãy thử APIDock, đặc biệt nếu bạn đang tìm kiếm một API trong một ứng dụng Rails cũ hơn.
Khi bạn có thể tìm thấy tài liệu ngay lập tức, nó sẽ biến đổi năng suất Rails của bạn. Bạn sẽ không chỉ tập trung hơn mà thậm chí còn tìm hiểu thêm về các thư viện và khuôn khổ mà bạn phụ thuộc vào.
Bạn không thể biết mọi thứ về mọi công cụ bạn sử dụng. Bạn sẽ luôn dựa vào tài liệu ở một số cấp độ. Vì vậy, hãy dành một ít thời gian ngay bây giờ để tiết kiệm thời gian khi tra cứu mọi thứ. Nó sẽ được đền đáp xứng đáng trong toàn bộ sự nghiệp lập trình của bạn.