매뉴얼웍스 6.0.18 버전부터 1브랜치(Branch)와 풀 리퀘스트(Pull Request) 기능을 지원합니다. 원본 장을 바로 수정하지 않고 별도의 작업 공간에서 내용을 바꾼 뒤, 변경 사항을 검토하고 원본 장에 반영할 수 있는 기능입니다.

문서를 함께 만들다 보면 “지금 바로 고치기에는 부담스러운 변경”이 생깁니다. 새 절을 추가하거나, 이미 공개한 도움말의 설명을 크게 바꾸거나, 여러 단락을 옮겨야 할 때가 그렇습니다. 작은 오탈자 수정은 바로 반영해도 괜찮지만, 구조가 바뀌는 변경은 먼저 따로 작업하고 확인한 뒤 반영하는 흐름이 필요합니다.

브랜치와 풀 리퀘스트는 이런 상황을 위해 만들었습니다.

원본 장은 그대로 두고 작업하기

2브랜치는 특정 장을 기준으로 만드는 독립적인 작업 공간입니다. 브랜치를 만들면 선택한 장의 내용이 복사되고, 그 안에서 장 제목과 단락을 자유롭게 수정할 수 있습니다.

브랜치에서 다음과 같은 작업을 할 수 있습니다.

• 장 제목 수정

• 단락 내용 수정

• 단락 추가와 삭제

• 단락 이동

• 단락 유형, 사용자 정의 아이디, 옵션 변경

브랜치에서 내용을 바꿔도 원본 장은 바로 바뀌지 않습니다. 그래서 공개 중인 문서나 다른 사람이 함께 보는 문서를 안정적으로 유지하면서 변경안을 준비할 수 있습니다.

변경 사항을 장 전체 문맥에서 확인하기

브랜치 화면에서는 원본 장과 브랜치의 차이를 확인할 수 있습니다. 단순히 바뀐 단락만 나열하지 않고, 장 전체 내용 안에서 어느 부분이 추가, 삭제, 이동되었는지를 보여줍니다.

문서 변경은 단락 하나의 문장만 보는 것으로 충분하지 않을 때가 많습니다. 앞뒤 문맥, 제목 구조, 단락 순서가 함께 맞아야 합니다. 브랜치의 변경 사항 화면은 이런 문맥을 확인하며 검토할 수 있도록 구성했습니다.

풀 리퀘스트로 검토 요청하기

작업이 끝나면 풀 리퀘스트를 만듭니다. 풀 리퀘스트는 브랜치에서 작업한 내용을 원본 장에 반영해 달라고 요청하는 절차입니다.

풀 리퀘스트를 만들면 그 시점의 브랜치 내용이 검토 기준으로 저장됩니다. 이후 브랜치에서 내용을 더 수정하더라도 이미 만들어진 풀 리퀘스트에는 포함되지 않습니다. 검토자는 풀 리퀘스트 화면에서 변경 사항을 확인하고, 필요한 경우 댓글로 의견을 남긴 뒤 병합하거나 닫을 수 있습니다.

원본 장이 바뀌었을 때의 충돌 처리

풀 리퀘스트를 만든 뒤 원본 장이 바뀌면 충돌이 발생할 수 있습니다. 이때는 충돌이 난 3단락별로 브랜치의 변경 내용을 반영할지, 아니면 무시할지를 선택한 뒤 병합합니다.

모든 변경을 무조건 덮어쓰는 방식이 아니라 단락 단위로 처리할 수 있기 때문에, 검토자는 원본 장의 최신 변경과 브랜치의 변경을 비교하며 더 신중하게 반영할 수 있습니다.

이런 작업에 특히 유용합니다

브랜치와 풀 리퀘스트는 다음과 같은 문서 작업에 잘 맞습니다.

• 릴리스에 맞춰 도움말 장을 크게 수정할 때

• 여러 사람이 같은 장의 변경을 검토해야 할 때

• 공개 문서를 바로 수정하지 않고 초안을 먼저 준비해야 할 때

• 단락 이동이나 삭제처럼 실수하면 영향이 큰 변경을 확인해야 할 때

• 작성자와 문서 소유자가 분리된 검토 흐름을 운영할 때

하나의 브랜치와 풀 리퀘스트는 각각 하나의 장만 다룹니다. 변경 범위를 작게 나누면 검토가 쉬워지고, 병합할 때 충돌 가능성도 줄어듭니다.

자세한 사용 방법은 브랜치와 풀 리퀘스트 장을 참고합니다.