인용 파일 형식(CFF)으로 소프트웨어가 저장소 루트에서 스스로를 인용하게 하다

논문에는 표제지가 있지만 연구 소프트웨어에는 흔히 없었다. 사용자는 코드를 볼 수는 있었으나 정확한 저자 목록, 버전, DOI, 선호 인용 방식을 알 수 없었기에 소프트웨어는 일관성 없이 인용되거나 아예 인용되지 않았다.

인용 파일 형식은 거의 인프라 없이 이 문제를 해결했다. 관리자가 저장소 루트에 평문 YAML 파일인 `CITATION.cff`를 추가한다. 이 파일은 사람과 기계에게 소프트웨어나 데이터셋을 정확히 인용하는 방법을 알려 준다.

도입을 이끈 지렛대는 플랫폼 지원이었다. GitHub는 CFF를 읽고 APA 및 BibTeX 출력과 함께 '이 저장소 인용' 안내를 노출하며, Zenodo와 Zotero는 저자에게 메타데이터를 다시 입력하도록 요구하지 않고 동일한 메타데이터를 재사용할 수 있다.

인용 메타데이터를 코드 옆에 두기

파일 이름이 관례적이며 저장소 루트에서 발견 가능하다.

YAML은 파일을 사람이 작성할 수 있게 유지하면서도 검증과 변환에 충분한 구조를 갖추게 했다.

플랫폼 렌더링이 관리자의 관례를 최종 사용자 워크플로로 바꾸었다.

선호 인용을 통해 소프트웨어 메타데이터를 잃지 않으면서 논문이나 데이터셋을 가리킬 수 있다.

출처 표시가 문제일 때, 최선의 표준은 사용자가 이미 프로젝트를 찾아보는 지점에 두는 작은 파일일 수 있다.

CFF는 코드 호스팅과 학술 인용 사이의 실용적인 다리가 되었다. GitHub는 CITATION.cff 파일에 대한 직접 지원을 문서화하고 이를 APA 및 BibTeX로 렌더링하며, CFF 프로젝트는 GitHub, Zenodo, Zotero의 지원을 언급한다.