실제 업무로 써 보세요
Voice Type은 macOS용 기기 내 받아쓰기입니다. 단축키를 누르고 말하면 입력 중인 앱에 텍스트가 들어갑니다. 음성은 Mac 밖으로 나가지 않습니다. 7일 무료, 이후 19.99달러(USD) 한 번 결제 로 Mac App Store에서 구매합니다. 구독도 계정도 필요 없습니다.
무료 체험 시작무엇이 바뀌었는지는 diff에 이미 나와 있습니다. 설명은 "왜"를 말하기 위해 있고, 그것은 글입니다. 직접 타이핑하는 일이 브랜치를 머지하기 전 마지막 관문이라 다들 대충 쓰고 넘어가는 부분이기도 합니다.
PR만의 동작: 본문이 미리 채워져 있습니다
저장소에 .github/pull_request_template.md 파일이 있으면, PR을 열 때 GitHub가 그 내용을 설명란에 불러옵니다. 문서 전체를 받아쓰는 것이 아니라, 이미 있는 제목 사이의 빈 곳에 받아쓰는 것입니다. 커서를 의도적으로 놓기만 하면 오히려 더 쉽습니다.
- 먼저 템플릿을 읽고, 말을 시작하기 전에 각 제목 아래에 무엇을 넣을지 정합니다.
- 한 제목 아래의 빈 줄을 클릭해 그 부분을 받아쓰고, 멈춘 다음 다음 제목을 클릭합니다.
- 처음부터 끝까지 한 번에 받아쓰지 마세요. 엉뚱한 제목 아래에서 "new line"이라고 말하면 테스트 계획이 요약 안에 묻혀 버립니다.
함정: 받아쓴 대괄호가 체크리스트에 체크를 합니다
대부분의 PR 템플릿은 작업 목록 형식으로 쓴 체크리스트입니다. "open bracket x close bracket"라고 받아쓰면 체크된 상자가 만들어집니다. 자동 완성으로 잘못 들어간 대괄호 쌍도 마찬가지입니다. 모든 상자에 체크된 템플릿을 본 리뷰어는 당신이 확인을 마쳤다고 생각합니다. PR을 열기 전에 "Preview" 탭에서 의도하지 않게 체크된 상자가 없는지 확인하세요.
멘션과 이슈 선택기는 이슈에서와 똑같이 동작합니다. "at"라고 받아쓰면 사용자 자동 완성이 열리고, "hash"이라고 받아쓰면 이슈 선택기가 열립니다. Command+Return으로 제출됩니다.
말로 입력할 것과 직접 타이핑할 것
- 받아쓰기: 변경 동기, 접근 방식, 받아들인 트레이드오프와 버린 트레이드오프, 그리고 리뷰어가 가장 꼼꼼히 봐 주었으면 하는 위험 요소. 모두 글로 쓰는 내용이고, 리뷰를 빠르게 만드는 것도 바로 이 내용입니다.
- 받아쓰기: 테스트 계획은 말로 한 문장으로 입력한 다음, 나중에 글머리 기호로 정리합니다.
- 직접 타이핑: 파일 경로, 함수 이름, 플래그 이름, 버전 번호, 코드 블록 안의 모든 내용. 음성으로는 대소문자와 구분 기호가 틀리기 쉽고, 식별자가 틀리면 리뷰어가 엉뚱한 파일을 보러 가게 됩니다.
설명 받아쓰기
- 받아쓰기를 한 번만 켜 두세요. 시스템 설정 → 키보드 → 받아쓰기 순서로 들어갑니다. 자세한 단계는 macOS에서 받아쓰기 켜는 방법을 참고하세요.
- 풀 리퀘스트를 열고, 설명란을 부분별로 하나씩 클릭합니다.
- 그 부분의 글을 받아쓰고, 커서를 옮기기 전에 멈춥니다.
- 식별자와 코드 블록은 직접 타이핑합니다.
- "Preview" 탭을 열어 체크박스와 멘션을 확인한 뒤 제출합니다.
아무것도 입력되지 않는다면
- GitHub는 브라우저에서 실행되므로 마이크 권한은 브라우저와 받아쓰기 도구에 필요합니다. 시스템 설정 → 개인정보 보호 및 보안 → 마이크에서 확인하세요.
- GitHub만이 아니라 어디서도 받아쓰기가 안 된다면: Mac에서 받아쓰기가 작동하지 않을 때.
에디터에서 리뷰까지, 하나의 단축키로
Voice Type은 키 입력을 흘려보내지 않고 완성된 텍스트를 한 번에 입력합니다. 그래서 자동 완성이 열리지 않고, 같은 단축키를 에디터, 터미널, 리뷰 스레드에서 모두 쓸 수 있습니다. 자세한 내용은 Mac용 음성 입력을 참고하세요.