(얼마 전에 이 게시물을 내 목록에 보냈습니다. 이 게시물이 재미있고 더 많은 것을 읽고 싶다면 가입해야 합니다!)
Rails 생태계는 인쇄하기에 너무 빠르게 움직입니다. 저와 같다면 최신 버전의 프레임워크와 젬을 배우고 싶을 것입니다. 그러나 최고의 리소스는 종종 몇 가지 버전 뒤에 있습니다.
그러나 이러한 리소스는 여전히 유용합니다. 도서관의 API, 철학 및 구조를 배우기 위해 잘 편집된 책, 스크린캐스트 또는 자습서만한 것은 없습니다.
예를 들어, 최고의 Rails 책이 Rails 4.0에 대해서만 설명한다면, 여전히 거기에서 시작해야 합니다. 새로운 보석이나 프레임워크를 배울 때 이유를 배우는 것이 중요합니다. 특정 방식으로 설계되었으며 모든 부품이 서로 잘 어울리는 방식입니다. 참고 문서와 블로그 게시물에서 얻기는 어렵지만 책에서는 쉽게 얻을 수 있습니다.
그러나 이전 버전의 gem으로 경험을 쌓고 나면 어떻게 따라잡을 수 있을까요?
변경 사항 파악
가장 인기 있는 보석은 번들러(https://github.com/bundler/bundler/blob/master/CHANGELOG.md)와 같은 git 저장소에 CHANGELOG 파일이 있습니다. 이는 버전 간 큰 변경 사항을 따라잡을 수 있는 좋은 방법입니다. 일반적으로 각 주요 변경 사항에 대한 간략한 요약입니다. 하지만 시작점을 제공하므로 흥미로운 변경 사항에 대해 더 많이 조사할 수 있습니다.
많은 변경 로그가 GitHub의 버그 번호를 참조합니다. 변경 로그에 버그 번호가 첨부된 항목이 있는 경우 프로젝트의 문제에서 버그를 찾아 무엇이 변경되었는지, 어떻게 변경되었는지, 왜 변경되었는지 이해할 수 있습니다.
그렇다면 어떻게 변경 로그를 찾을 수 있습니까? 일반적으로 Google에서 bundler github를 검색합니다. (번들러 변경 로그를 찾고 있는 경우), 일반적으로 첫 번째 GitHub 페이지에 있습니다.
변경 로그가 없으면 GitHub에서 프로젝트의 README 또는 프로젝트의 위키를 볼 수도 있습니다. 하지만 버전별로 따라잡는 데 도움이 되도록 설계되지 않았기 때문에 일반적으로 처리하는 데 시간이 더 오래 걸립니다.
최신 참조 문서 사용
gem으로 작업할 때 최신 참조 문서도 유지해야 합니다. 이렇게 하면 자신의 앱을 작성하는 동안 API 사용을 조회하고 예제를 볼 수 있습니다.
rdoc.info에서 모든 gem 버전에 대한 API 문서를 찾을 수 있습니다. 하지만 더 빠른 문서 조회를 위해 Dash 또는 Zeal을 확인해야 합니다.
저는 Dash를 사용하기 때문에 API 문서를 검색해야 할 때 option-Space를 누르고 입력을 시작하면 모든 gem 문서가 즉시 표시됩니다. 내 워크플로의 변화는 그 자체로 여러 번 보상을 받았습니다.
Rails에 대한 몇 가지 팁, 특히
Rails는 대규모 프로젝트이며 Rails 기여자는 변경 로그 및 문서를 유지 관리하는 일을 훌륭하게 수행합니다.
Rails 가이드가 좋음 , 그리고 Rails와 동일한 git 저장소에서 빌드되므로 항상 최신 상태를 유지합니다.
최신 버전의 Rails를 따라잡고 싶다면 릴리스 노트가 가장 좋은 시작점입니다. 예를 들어 다음은 Rails 4.1의 릴리스 정보입니다. https://guides.rubyonrails.org/4_1_release_notes.html
내가 일반적으로 취하는 절차
이 모든 것을 종합하면 새 라이브러리에 대한 최신 정보를 얻고 싶을 때 수행하는 작업입니다.
- 젬에 대한 책, 튜토리얼 또는 문서를 읽으십시오. 나는 보통 내가 할 수 있는 가장 최신의 자료를 찾으려고 노력한다. 책을 읽는 동안 배우고 있는 버전에 따라 앱을 만들고 연습 등을 합니다.
- GitHub에서 프로젝트를 찾습니다.
- 프로젝트의 변경 로그, 추가 정보 또는 Wiki를 읽고 내가 알고 있는 버전에서 가장 최신 버전으로 이동합니다.
- 특정 변경 사항에 관심이 있는 경우 Google에서 찾아보거나 프로젝트 문제를 살펴보고 자세히 알아보세요.
- 최신 버전의 gem으로 업그레이드하세요.
- Dash에 새로운 gem의 문서를 설치하세요.
- 코드를 작성하세요!
나는 항상 모든 단계를 수행하지 않습니다. 하지만 일반적으로 그것이 내가 가는 순서이고, 이런 종류의 프로세스는 내가 한 단계에 갇히거나 다음으로 가야 할 곳을 모르는 경우를 대비해 유지하는 데 도움이 됩니다.
변경 로그를 찾을 수 없거나 이해할 수 없는 경우 문서?
때로는 gem의 GitHub 리포지토리나 API 문서에서 필요한 정보를 얻지 못할 수도 있습니다. 그런 일이 발생하면 코드를 자세히 살펴보고 읽기 시작해야 합니다.
놀랍게도 코드를 읽는 것은 책을 읽는 것과는 다릅니다. 파일을 처음부터 끝까지 읽는 대신 탐색해야 합니다. 코드. 이것은 과학보다 예술에 가깝지만 배워야 할 중요한 기술입니다. 그래서 나중에 더 많은 이야기를 해야 할 것 같습니다!
보석 변경 사항을 파악하기 위해 어떤 트릭을 배웠습니까? 어떻게 최신 상태를 유지합니까?