레일 연습이 끝났습니다! 2월 13일 금요일까지 25% 할인된 가격에 만나보세요.
코드를 작성하는 동안 지속적으로 질문이 떠오릅니다. :이 메서드를 어떻게 호출합니까? 어떤 옵션이 필요합니까? 숫자 대신 개체를 전달하면 어떻게 됩니까?
이러한 질문은 생산성을 떨어뜨립니다. 바로 답을 모를 때, 당신은 당신이 무엇을 하고 있었는지 잊어버립니다. 흐름에서 빠져 나와 중단한 지점으로 돌아오려면 30분이 걸립니다.
그렇다면 속도를 늦추지 않고 어떻게 필요한 답변을 찾을 수 있을까요?
빠른 조회
API 문서를 조회할 때 속도가 핵심입니다. 당신은 당신의 대답을 얻고 가능한 한 빨리 나가기를 원합니다. 그렇지 않으면 궤도에서 벗어나기가 너무 쉽습니다. 얼마나 자주 메소드의 매개변수를 알아야 했는지 셀 수도 없고 어떻게든 한 시간 동안 reddit에서 당황스러운 문자 메시지를 보게 되었습니다.
빠른 문서화를 위해서는 Mac의 경우 Dash가 필요하고 다른 모든 경우에는 Zeal이 필요합니다. 이 도구를 사용하면 키보드에서 두 개의 키를 누르고 수행 중인 작업에 대해 생각할 필요 없이 필요한 문서를 불러올 수 있습니다.
하지만 먼저 약간의 설정이 필요합니다.
이 앱 중 하나를 다운로드한 후 다음 두 가지를 수행하십시오.
-
사용하는 라이브러리의 문서 세트를 다운로드하세요.
Ruby, Rails, CSS, HTML 및 Javascript에 대한 문서를 가져오고 그게 전부입니다. Nokogiri와 같이 많이 사용하는 복잡한 보석이 있으면 해당 문서도 가져옵니다. 그러나 너무 과도하게 사용하지 마십시오. 문서가 너무 많으면 어떤
concat당신이 실제로 의미하는 방법. -
전체 검색 바로가기 설정 . Mac에서는 보통 스페이스바 옵션을 사용합니다.
이것이 Dash를 "또 다른 문서 사이트"에서 완전히 필수적인 도구로 변화시키는 것입니다. 전역 검색 바로 가기를 설정하면 옵션-스페이스바를 누르고, 입력을 시작하고, 필요한 문서를 보고, 옵션-스페이스바를 다시 누르고, 방금 한 일을 깨닫지 않고도 답을 얻을 수 있습니다. API 질문이 있다는 것을 알기도 전에 답변할 수 있습니다.
세부정보, 질문 및 의견
불행히도 API 문서에 알고 싶은 모든 세부 정보가 없는 경우가 있습니다. 또는 기능이 내부에서 어떻게 작동하는지 알아야 할 수도 있습니다.
이러한 질문에 답하려면 속도를 희생해야 합니다. 하지만 그 속도를 디테일과 커뮤니티로 대체하는 문서 사이트가 있습니다.
APIDock
APIDock은 Ruby, Rails 및 RSpec만 다룹니다. 하지만 여전히 유용합니다.
-
APIDock은 Rails 메소드가 지원 중단된 시기와 대신 사용해야 하는 방법을 알려줍니다. 1.0까지 거슬러 올라가는 Rails의 버전 간 변경 사항을 추적합니다. 따라서 레거시 Rails 코드로 작업하는 경우 놀라운 리소스입니다.
-
많은 API 메소드에 Rails 개발자가 기고한 주석이 있습니다. 댓글이 정말 좋습니다. APIDock을 사용하면 전에 극단적인 경우와 일반적인 문제에 대해 듣게 됩니다. 당신은 그들과 충돌합니다.
새 문서 워크플로
이 모든 것을 어떻게 조합합니까?
- API에 대한 질문이 있는 경우 단축키를 사용하여 Dash 또는 Zeal을 빠르게 불러오세요.
- 자세한 내용이 필요하면 웹으로 이동하십시오. 특히 이전 Rails 앱에서 API를 검색하는 경우 APIDock을 먼저 사용해 보세요.
문서를 즉시 찾을 수 있게 되면 Rails 생산성이 달라질 것입니다. 더 집중할 수 있을 뿐만 아니라 의존하는 라이브러리와 프레임워크에 대해 더 많이 배울 수 있습니다.
사용하는 모든 도구에 대해 모든 것을 알 수는 없습니다. 어느 정도는 항상 문서에 의존하게 됩니다. 그러니 지금 조금 시간을 내어 검색할 때 시간을 절약하세요. 전체 프로그래밍 경력을 통해 큰 성과를 거둘 것입니다.