RailsGuides(JP)에 PR을 보내려면

의 목적

RailsGuides를 참고로 프로그램을 시작한 후 예상대로 움직이지 않는 등 RailsGuides에 문제가 있을 때 PR을 수정하고 발송하는 절차를 기재했다.

절차.

Giithub에서 fork Rails Guides.

RailsGuides의 PR은 포크의 창고 push 분기로 주체에게 알리는 프로세스다.

클론 RailsGuides

$ git clone https://github.com/<forkしたアカウントID>/railsguides.jp.git

로컬 시작RailsGuides

$ bundle install
$ bundle exec rake assets:precompile
$ bundle exec jekyll server

방문http://localhost:4000.

RailsGuides 편집

우선master 분기patch-1에서 분기(숫자 1은 매번 PR 횟수가 증가할 때마다 가산한 것이다. 단지 자신이 이렇게 하는 것은 정확하지 않을 수도 있다).

$ git branch patch-1 master
$ git checkout patch-1

편집기에서 /guides/source/ja 소속 대상 파일 (.md) 을 찾아서 편집합니다.
　railsguides.브라우저에서 jp로 수정하고 싶은 페이지를 열면 URL에서 대상 파일 이름을 알 수 있기 때문에 곧 파일을 찾을 수 있을 것 같습니다.

https://railsguides.jp/<ここがmdファイル名と一致する>.html

편집이 완료되면 진행add / commit / push합니다.push면본체(yasslab/railsguides.jp)의Giithub를 보면 PR을 할 수 있기 때문에 PR 내용을 알기 쉽게 써서 통합을 요청합니다.

홍보를 하기 전에 주의해야 돼요.

Rails 본가에서도 확인해 주세요.

오역이 아닌 코드 오류 등RailsGuide(본사)에도 영향을 미치는 경우 수정됐는지 확인해 본다.(라일스 위원이 될 기회?)
그러나 본사에도 EdgeGuides라는 최신 수정 제출 페이지가 있는데 거기서 수정하면 본사는 이미 수정이 끝났으니 주의해야 한다.

수정 내용 다시 확인

문장을 교정하면 정말 쉽게 읽을 수 있는지, 코드를 수정하려면 확인 동작을 실제로 실행해 오류가 없는지 확인해야 한다.(혹시 모르니까)

실제로 했던 PR 리스트.

PR 목록
개요
#702
Active Record 호출 애프터 터치 출력 수정
#707
출력 Action View 요약 모음의 코드 수정

더 해보고 싶었던 것들.

PR 목록
개요
rails #33898
Improve readability in form helpers guide [ci skip]
rails-jp #712
Improve readability in form helpers guide by white space

참고 자료

RailsGuides 일본어 번역 README
이 기사는 낡으면 프로그램이 바뀔 수 있으니 README 참고를 추천합니다.
내 블로그
#702에 대한 수정 사항과 문제점에 대해 설명합니다.