업로드하기

패치 업로드하기

사용설명서 수정 입문자라면, 사용설명서 관리자가 검토할 수 있도록 패치 형태로 보내주어야 해요. 우리가 믿음직한 사용설명서를 유지하기 위해 꼭 필요한 과정이에요. 처음 하는 사람이 혹시라도 중요한 데이터를 건드리면 안 되니까요.

패치를 업로드하려면 이 순서대로 따라해주세요.

  1. 일단 수정을 다 마쳤겠죠?

  2. 이 명령어로 패치 파일을 만드세요.

    svn diff > filename.diff
    

    원래 서버로부터 동기화된 폴더에서 어떤 내용이 추가되고, 없어지고, 수정되었는지를 정리해둔 간단한 텍스트 파일이 만들어질 거예요.

    파일을 새로 만들었거나 삭제했다면, svn add /path/to/file 이나 svn rm /path/to/file 명령어를 diff를 만들기 전에 실행해주세요. 변경된 파일들의 목록을 보려면 svn status 명령어를 실행하면 돼요.

  3. 여기에 그 diff파일을 업로드해주세요. 아직 계정이 없다면, 여기서 쉽게 만들 수 있어요.

  4. diff를 보내주고 나면, 제목과 설명을 쓰면서 새 개정본을 만들지(create a new revision) 질문받을 거예요.

  5. 문서화 프로젝트(documentation project)의 다른 팀 멤버가 그 게시글을 볼 수 있도록 documentation project를 꼭 태그해 주세요. 연락처 에서 이메일로 팀에 연락하거나 IRC 채널을 사용할 수도 있어요.

  6. 그러면 팀 멤버들이 패치를 검토해서 기여자님에게 다시 수정을 요청하거나, 사용설명서에 반영해서 기여자님한테 알려줄 거예요.

참고

만약 패치에 이미지 변경사항이 포함되어 있다면, 개정본을 만들 때 이미지도 같이 첨부해 주세요.

올바르게 잘 만들어진 패치는 아주 빠르게 반영돼요. 기여자님이 몇 번 하고서 이 일에 익숙해지고 피드백이 없어도 되는 수준이 되면, 검토 단계를 빼고 기여자님에게 특별히 사용설명서를 직접 수정할 권한을 줄 거예요.

직접 업로드하기

수정 권한을 받고 나면 패치 파일을 만드는 대신, 서버 저장소에 직접 파일을 업로드할 수 있게 돼요.

이 명령어를 실행하면 돼요.

svn commit -m "This is what I did"

-m "message" 를 명령어에 안 썼다면, 텍스트 편집기에서 메시지를 쓰라고 할 거예요.

업로드하기 전에 ``svn update``를 꼭 실행하세요.

commit 명령어를 실행했다면, developer.blender.org 계정 이름과 비밀번호를 입력하라고 할 거예요.

수정된 파일은 중앙 저장소에 곧바로 업로드되어 다른 사람들과 함께 공동으로 작업할 수 있어요. 업로드한 내역은 Diffusion 저장소에 남게 돼요. 조금 있으면 변경사항이 온라인 사용설명서에 반영될 거예요.