본 번역은 검증되지 않았습니다. AIP를 통해 영문원문으로부터 번역되었습니다.

온톨로지 제안

온톨로지 제안은 주 버전에 기반한 브랜치에서 온톨로지에 대한 변경사항을 제안할 수 있게 해줍니다. 이 과정은 모든 수정사항이 주 온톨로지에 통합되기 전에 검토하고 승인하는 것을 보장합니다.

Foundry에서 브랜치에 대해 더 알아보기.

정의

  • 브랜치: 온톨로지에서 브랜치는 해당 온톨로지의 별도 버전으로, 주 버전에서 파생되어 주 브랜치에 영향을 미치지 않고 실험하고 변경사항을 만드는 데 사용됩니다. 이를 통해 사용자는 별도의 환경에서 온톨로지에 대한 조정사항을 테스트하고 개선할 수 있습니다.

  • 제안: 제안은 버전 관리 시스템의 Pull Request에 비유할 수 있으며, 특히 온톨로지 브랜치를 위해 맞춤화되어 있습니다. 제안은 브랜치와 함께 자동으로 생성되며 리뷰, 이름, 주 브랜치에 병합되는 변경사항의 설명과 같은 메타데이터를 포함합니다. 제안은 별도의 브랜치에서 만들어진 변경사항을 검토하고 승인하기 위한 메커니즘으로 작동합니다.

제안 워크플로

  1. 브랜치 생성

브랜치 생성을 선택하여 제안의 제목과 설명을 선택할 수 있는 대화 상자를 열어 브랜치를 생성할 수 있습니다.

또한, 제안에 포함시키고자 하는 온톨로지에 대한 변경사항이 이미 있는 경우, 저장을 선택하고 저장 대화 상자에서 변경사항 제안을 토글할 수 있습니다.

변경사항 제안

온톨로지의 주 브랜치에 있고 변경사항이 없는 경우, 브랜치 선택 구성 요소를 선택하고 새 브랜치에 이름을 입력하여 브랜치를 생성할 수도 있습니다.

제안 브랜치는 주 온톨로지 설정에서만 생성할 수 있습니다. 다른 제안을 기반으로 새 브랜치를 생성할 수는 없습니다.

브랜치에 있을 때, 작업 공간 인터페이스 위에 위치한 브랜치 탐색 상단 바가 현재 브랜치를 반영합니다.

브랜치 탐색 상단 바

  1. 리뷰를 위해 제안 준비

이 시점에서 제안을 생성하는 방법에 따라 브랜치에 이미 일부 변경사항이 있을 수 있습니다. 브랜치에 있을 때, 온톨로지 자원에 대한 변경사항을 계속 만들 수 있으며, 이에는 생성과 삭제가 포함됩니다.

수정된 모든 온톨로지 개체는 제안에서 별도의 작업을 구성하며, 리뷰를 위해 사용할 수 있습니다.

온톨로지 역할을 사용하여 마이그레이션한 자원의 경우, 뷰어는 제안에서 자원에 대한 변경사항을 만들 수 있습니다. 자원이 데이터소스 파생 권한에 있으면, 에디터나 소유자만 제안에서 그것들에 대한 변경사항을 만들 수 있습니다.

브랜치에서는 에디터 또는 소유자 권한을 가진 경우 자원을 편집할 수 있습니다. 또한 뷰어 권한이 있는 자원을 편집할 수 있으며, 이런 자원들은 새로운 온톨로지 역할을 사용하게 마이그레이션되었습니다. 자원을 온톨로지 역할을 사용하도록 마이그레이션하려면, 온톨로지 역할 마이그레이션 가이드를 따르세요.

  1. 리뷰 요청

브랜치에 변경사항을 만든 후에는 제안에 리뷰어를 추가할 수 있습니다. 그렇게 하려면, 상단 바에 위치한 제안 세부사항 열기를 선택하여 제안 보기로 이동합니다.

브랜치를 종료한 경우, 제안 탭으로 이동하여 제안을 선택하거나 브랜치 선택 구성 요소를 사용하여 제안 개요로 이동할 수 있습니다.

거기에서 리뷰어 섹션에서 리뷰어를 지정합니다.

제안이 리뷰 중 단계에 있을 때까지 리뷰어에게 알림이 전송되지 않습니다.

제안에서 여러 작업에 대한 코멘트를 남겨 제안된 변경사항에 대한 맥락을 제공할 수도 있습니다. 리뷰 탭을 선택하고, 그 다음으로 가장 오른쪽에 있는 코멘트 사이드바를 선택하여 작업의 코멘트 섹션에 접근하세요.

  1. 제안 검토

리뷰어는 리뷰 탭에서 개별 작업을 승인하거나 거부할 수 있으며, 리뷰를 지원하기 위해 코멘트를 추가할 수 있습니다.

변경사항을 승인할 수 있는 리뷰어는 소유자 또는 편집 권한을 가져야 합니다.

권한이 없는 사용자도 작업을 검토할 수 있으며, 예를 들어 변경사항에 대한 의견을 전달하기 위해, 하지만 이것은 작업의 승인 상태에 영향을 주지 않습니다.

제안의 작성자가 모든 편집된 자원에 대해 소유자 또는 에디터 권한을 가지고 있는 경우, 자신의 변경사항을 승인할 수 있습니다.

에디터 또는 소유자가 명시적으로 리뷰어로 추가되지 않더라도 제안을 승인할 수 있습니다. 누가 변경사항을 검토해야 하는지 추적하기 위한 방법으로 리뷰어 목록을 사용하는 것이 좋지만, 온톨로지를 보호하는 방법으로는 사용하지 않는 것이 좋습니다. 이는 대신 역할 또는 권한의 신중한 할당을 통해 이루어져야 합니다.

  1. 제안 릴리스

변경사항이 검토되고 승인되면 제안을 온톨로지에 병합할 수 있습니다.

온톨로지에 변경사항을 병합하는 데는 특별한 권한이 필요하지 않습니다. 제안이 승인된 후에는 브랜치를 편집할 수 있는 누구나 온톨로지에 제안을 병합할 수 있습니다.

제안이 병합되면, 사이드바의 리뷰 중 섹션에서 병합됨 섹션으로 이동됩니다.

제안을 병합하기 전에 언제든지 사이드바에서 삭제를 선택하여 제안을 닫을 수 있습니다.

제안은 주 온톨로지 설정에만 병합할 수 있습니다.

제안은 자동으로 되돌릴 수 없습니다. 제안을 취소하려면 그 안의 다른 변경사항을 취소해야 합니다.

제안이 닫히면 다시 열 수 없습니다.

제안 닫기

제안 탐색

  • 브랜치 탐색 바: 브랜치를 편집할 때 작업 공간 상단에 나타납니다. 여기서 다음과 같은 작업을 수행할 수 있습니다:

  • 주 브랜치로 돌아가기 (1)

  • 제안 세부사항 보기 (2)

  • 브랜치 선택기를 사용하여 특정 브랜치로 이동하기 (3)

브랜치 탐색 상단 바

  • 브랜치 선택: Ontology Manager 홈페이지의 브랜치 선택 섹션에서 직접 편집하거나 볼 브랜치를 선택합니다.

브랜치 선택 닫힘

브랜치 선택 열림

  • 제안 탭: 제안 탭에서는 다른 상태의 제안을 보거나 선택할 수 있습니다. 상태의 정의는 아래에 나와 있습니다:

    • 내 제안: 당신이 작성한 제안.
    • 나에게 할당된 제안: 리뷰어로 할당된 제안.
    • 리뷰 중: 진행 중이거나 승인된 제안.
    • 병합된 제안: 온톨로지에 병합된 제안.
    • 닫힌 제안: 닫혀 있고, 병합되지 않은 제안.

    제안 탭

  • 제안 보기: 제안에 대한 자세한 정보를 얻기 위해 개요, 리뷰, 변경 로그 탭에 접근하세요.

제안 보기

제안 개요는 제안에 대한 정보를 중앙에 모아두어, 제안이 어떤 단계에 있는지, 어떤 변경사항이 이루어졌는지, 리뷰가 필요한 작업은 무엇인지, 선택된 리뷰어는 누구인지 알 수 있습니다. 현재 편집 중인 제안에 대한 이 보기에 접근하려면, 상단 바에서 제안 개요로 이동을 선택합니다. 어떤 제안의 개요 페이지에 접근하려면, 제안 탭으로 이동하여 보려는 제안을 선택하면 됩니다.

  • 제안 단계: 제안의 첫 번째 단계는 준비 단계입니다. 리뷰 요청을 선택하여 제안을 리뷰 중 단계로 이동시킵니다. 모든 작업이 검토되고 승인되면, 제안은 마지막 단계인 제안 병합으로 이동합니다. 이 시점부터, 같은 옵션을 사용하여 주 온톨로지에 변경사항을 병합할 수 있습니다.

  • 브랜치에서 변경사항 보기: 편집사항은 개요 페이지 하단에 표시됩니다. 편집사항은 작성자와 작업별로 분류되며, 작업은 온톨로지 자원에 해당합니다. 변경사항을 보거나, 자원으로 이동하거나, 그 변경사항을 버릴 수 있습니다. 변경사항의 히스토리는 변경 로그 탭에서도 접근할 수 있으며, 변경사항의 정확한 시간도 표시됩니다.

  • 리뷰어 보기 및 추가: 제안을 검토하도록 특정 동료를 지정합니다. 리뷰어는 제안이 리뷰 단계로 이동한 후에만 알림을 받습니다.

  • 주의가 필요한 작업 보기: 이 섹션에서는 리뷰 단계에서 거부된 모든 작업을 표시합니다.

제안 링크를 복사하여 동료와 쉽게 공유할 수 있습니다.

제안 개요

리뷰

리뷰 탭에서는 제안의 모든 작업을 보여줍니다. 여기에서 다음과 같은 작업을 수행할 수 있습니다:

  • 수정된 것을 확인하기 위해 각 작업의 세부사항을 확장
  • 작업 수준에서 코멘트를 남기고 동료와 협업
  • 작업 수준에서 작업을 승인하거나 거부, 또는 모든 자격이 있는 작업에 대해 일괄적으로 수행
  • 추가 리뷰어 요청

리뷰

변경 로그

변경 로그 탭에서는 브랜치에서의 변경사항에 대한 자세한 히스토리를 보여줍니다. 작업은 특정 시점에 특정 사용자가 한 편집을 보여주기 위해 확장될 수 있습니다. 또한 직접 관련 온톨로지 자원으로 이동할 수 있습니다.

변경 로그

제안 권한

  • 제안 보기: 제안의 제목과 설명은 온톨로지에 접근 가능한 모든 사람에게 발견될 수 있습니다. 제안의 일부 자원에 대해 적어도 뷰어 접근 권한이 있는 모든 사용자는 그 자원과 관련된 변경사항을 볼 수 있습니다.

  • 제안 생성: 온톨로지에 접근할 수 있는 누구나 제안을 생성할 수 있습니다.

  • 브랜치 편집: 생성자, 그리고 제안의 모든 편집된 자원에 대해 에디터 또는 소유자 권한을 가진 모든 사용자는 브랜치를 편집할 수 있습니다.

  • 브랜치의 엔티티 편집: 브랜치를 편집할 수 있는 사람(위 참조), 그리고 다음 두 조건 중 하나를 충족하는 사람은 브랜치의 자원을 편집할 수 있습니다.

    • 자원에 대해 편집 또는 더 높은 권한을 가지고 있다.
    • 뷰어 권한이 있고, 자원이 온톨로지 역할을 사용한다.
  • 제안의 작업을 수락하거나 거부: 누구나 변경사항을 승인하거나 거부하거나, 제안에 코멘트를 남길 수 있습니다. 작업이 승인으로 간주되려면, 승인자는 기본 자원의 에디터 또는 소유자여야 합니다.

  • 제안 릴리스: 제안이 승인되면, 브랜치를 편집할 수 있는 누구나 제안을 릴리스할 수 있습니다.

제안 설정

온톨로지 제안은 기본적으로 비활성화되어 있습니다. 그룹 관리자는 제어판의 온톨로지 설정에서 그룹에 대해 이 기능을 활성화할 수 있습니다.