번역 파이프라인 설계하기

책임 주체와 검토, 전달, 복구 절차를 명확히 정해 원문 변경을 실제로 사용할 수 있는 번역으로 연결하세요.

번역 파이프라인은 원문 변경 사항이 이를 필요로 하는 시스템에서 실제로 사용할 수 있는 콘텐츠가 되어야 완성됩니다. 번역 생성은 그중 한 부분일 뿐입니다. 워크플로는 올바른 리비전을 식별하고, 해당 리비전의 대상 번역을 가져오고, 승인된 작업을 보존하며, 게시 가능한 내용을 결정할 수 있어야 합니다.

먼저 저장소 카탈로그, 콘텐츠 관리 시스템의 문서, 애플리케이션 레코드 중 실제로 다룰 콘텐츠 유형 하나를 중심으로 설계하세요. 유형마다 책임 주체와 전달 방식이 다릅니다. 세 유형을 모두 똑같이 다루면 결과를 안전하게 사용할 수 있는지를 좌우하는 결정이 워크플로에 드러나지 않을 수 있습니다.

각 전환 단계의 책임 주체 정하기 #

저장소 카탈로그용 워크플로는 다음과 같이 설계할 수 있습니다.

전환 단계결정 사항
원문이 처리 대상이 됨생성된 대상 번역을 제외하는 신뢰할 수 있는 트리거를 사용해, 기록된 커밋에서 검토를 마친 원문을 번역합니다.
작업 시작명시적으로 지정한 로컬라이제이션 엔진, 로캘, 형식, 승인된 기준본을 사용하고, 필요한 경우 실행 승인을 받습니다.
대상 번역이 승인 가능한 상태가 됨지정된 검토자가 필요한 변경 사항을 살펴보고, 미해결 사항은 계속 확인할 수 있도록 유지합니다.
결과물 반환다운로드와 유효성 검사를 마친 리소스를 번역 풀 리퀘스트에 포함합니다.
콘텐츠가 독자에게 전달됨애플리케이션 릴리스에 변경 사항을 반영하고 해당 리소스 검사를 통과합니다.
결과를 되돌려야 함정상 작동이 확인된 리소스와 관련 설정 또는 기준본을 복원합니다.

이는 워크플로 설계 예시이지 제품의 기본 동작이 아닙니다. 각 결정이 실제로 지켜지도록 하는 장치를 명시하세요. 자동 제어 장치가 없는 팀 정책에는 준수 여부를 확인할 담당자를 지정해야 합니다.

책임 범위에 맞춰 도구 선택하기 #

기본 제공 연동은 설치 시 부여받은 권한으로 제공업체의 트리거와 결과 쓰기를 담당할 수 있습니다. CLI 실행기는 로컬에서 가져오기와 커밋을 담당합니다. API 호출자는 자체적으로 저장한 리비전과 결과물의 활성화를 담당합니다. 각 책임에 맞는 동작 규약을 지원 범위 안에서 선택하세요.

Studio는 번역 설정과 결정 사항을 관리하고, 데브툴스는 프로그래밍 방식과 파일 기반 실행을 지원하며, 레이더는 이용 가능한 측정 및 조사 근거를 제공합니다. 이들은 조합해 활용할 수 있는 기능이지, 반드시 순서대로 도입해야 하는 단계가 아닙니다.

선택한 제공업체의 수동·자동 모드, 초안 처리 방식, 사용 권한, 연결 해제 시 영향을 확인하세요. 콘텐츠 관리 시스템에 게시하는 연결과 저장소에 풀 리퀘스트를 여는 연결은 결과를 승인하는 지점이 서로 다릅니다.

리비전 간 연결 관계 유지하기 #

콘텐츠 식별 정보, 원문 리비전, 대상 로캘, 결과물의 리비전 또는 산출물, 설정, 승인 정보를 함께 보관하세요. 번역이나 검토 도중 더 최신 원문이 도착하면 어떻게 처리할지 정하세요. 이전 결과가 단지 가장 늦게 완료됐다는 이유로 현재 버전이 되어서는 안 됩니다.

재사용으로 승인된 대상 번역을 보존할 부분과 새로 생성할 부분을 정하세요. 같은 형식을 지원한다고 해서 API, CLI, 앱이 동일한 옵션을 제공하는 것은 아닙니다. 호출자가 사용하는 정확한 기준본과 강제 실행 시 동작을 설계에 반영하세요.

미해결 상황에 대비하기 #

입력 거부, 대상 번역 실패, 가져오기 중단, 검토 대기, 로컬 충돌, 불확실한 응답 이후의 처리 방식을 정하세요. 다음 조치는 해당 동작 규약에 따라 이미 확인된 작업을 복구하는 것이어야 합니다. 접수 확인 정보를 잃어버렸다는 이유로 모든 작업을 처음부터 다시 시작해서는 안 됩니다.

일부 대상 번역이 미해결 상태여도 완료된 다른 번역은 준비해 둘 수 있습니다. 릴리스에 모든 대상 번역이 필요한지, 아니면 대체 콘텐츠를 사용하기로 선택할 수 있는지 정하세요. 검토 정책은 결정 누락과 시간 초과 시의 처리 방식을 정합니다. 모든 도구에 통용되는 재시도 동작을 새로 만들기보다는 해당 작업을 담당하는 도구에서 실행을 제어하도록 하세요.

품질 근거를 해석할 수 있게 구성하기 #

Lingo.dev 외부에서 생성된 번역까지 포함해 릴리스에 중요한 질문을 정하세요. 측정은 검토가 필요한 작업을 식별하는 데 도움이 될 수 있지만, 그렇다고 측정 시스템이 승인된 콘텐츠를 관리하거나 게시 여부를 결정하는 시스템이 되는 것은 아닙니다.

측정 설계에서는 기준, 근거, 응답 상태, 보고 대상 집단을 설명합니다. 이러한 근거를 해석하고 불명확한 원문의 의미를 명확히 할 담당자를 지정하는 일도 워크플로에 포함하세요.

확장 전에 전체 주기 검증하기 #

원문 변경 하나를 제출부터 가져오기, 유효성 검사, 검토, 전달, 실제 사용까지 진행해 보세요. 안전한 시험 환경에서 처리 도중 원문을 변경하고 대상 번역 하나가 실패하는 상황을 재현해 보세요. 현재 리비전을 계속 식별할 수 있는지, 복구 과정에서 승인된 결과물이 보존되는지 확인하세요.

워크플로 시험을 통해 실제로 실행한 내용과 아직 시험하지 않은 내용을 기록하세요. 다른 운영자가 번역이 실제로 사용 가능한 상태가 되는 과정과 이전의 사용 가능한 상태로 복원하는 방법을 모두 설명할 수 있다면, 설계를 확장할 준비가 된 것입니다.