DESCRIPTION에 ROR ID가 있는 조직을 대폭 인정

ROR ID 활용: R 패키지에 조직 아이디를 추가하기 몇 년 전, R 커뮤니티에서는 ORCID(“Open Researcher and Contributor ID”)를 사용하여 DESCRIPTION 파일에서 패키지 저자를 지속적이고 유일하게 식별하기 시작했습니다. 아이디어는 다음과 같습니다. 저자의 ORCID를 person() 객체의 특별히 명명된 주석으로 입력합니다. 예를 들어 제 경우는 다음과 같이 표현될 수 있습니다. person("Maëlle", "Salmon", , "maelle@ropensci.org", role = c("cre", "aut"), comment = c(ORCID = "0000-0002-2815-0399")) 다른 누구라도 악의적이든 무심코든 ORCID를 사용할 수 있지만, 작업에 ORCID를 사용하면 확실히 이점이 있습니다. R 패키지의 경우, CRAN 페이지와 pkgdown 웹사이트에 ORCID 프로필로 연결되는 멋진 아이콘이 표시되어, 이후에는 좋아하는 온라인 존재로 연결될 수 있습니다. 인정! 개인 브랜딩! 올해에는 ROR(“Research Organizations Registry”) ID를 사용해 같은 아이디어를 조직에도 적용했습니다. 연구 조직, 이니셔티브, 기업 등 모든 조직이 레지스트리에 등록을 요청할 수 있습니다. 몇 달 전, DESCRIPTION에 ROR ID를 나열할 수 있게 되었으며, 현재 수십 개의 CRAN 패키지가 이를 사용하고 있습니다. 이는 여전히 ORCID를 채택한 패키지 수에 비해 부족하지만, R Core가 기능을 추가해 주고 Achim Zeileis가 소식을 전파해 주어 가능해졌습니다. 패키지 유지보수자는 DESCRIPTION에 조직을 나열해야 할 수도 있습니다. 예를 들어, 패키지의 저작권을 소유한 회사(“cph” 역할)나 소프트웨어 작업을 후원한 기관(“fnd” 역할)이 해당됩니다. 조직의 ROR ID를 person() 객체에 추가하면 조직을 더욱 명확하게 식별할 수 있습니다. 예시로 rOpenSci는 다음과 같이 표현될 수 있습니다. person("rOpenSci", role = "fnd", comment = c("https://ropensci.org/", ROR = "019jywm96")) ROR 아이콘은 ORCID 아이콘만큼 눈에 띄지 않지만, 패키지의 CRAN 페이지에 나타나며 조직의 ROR 페이지로 연결됩니다. 2018년에 ORCID 사용 도구에 대해 보고했으며, 올해는 ROR ID 포함 도구를 설명하고자 합니다. ROR 지원 in {devtools} 생태계 ROR ID가 base R에서 지원되면서, 다음 기술 단계는 Posit의 “devtools 생태계”에서도 지원되는 것이었습니다. devtools가 패키지 개발에 필수는 아니지만, rOpenSci 커뮤니티를 포함한 많은 패키지 개발자들이 devtools를 사용합니다. desc, roxygen2, pkgdown에서 ROR을 지원하는 코드는 ORCID를 지원하는 코드와 동일합니다. “orcid”가 “ror”보다 검색하기 더 쉬운 문자열이었기에 ORCID 지원이 먼저 추가된 것이 좋았습니다. ROR 지원 in {desc} {desc} 패키지는 Gábor Csárdi가 유지하며 DESCRIPTION 파일을 프로그래밍적으로 조작할 수 있게 도와줍니다. 현재 개발 버전에서는 저자(추가, 검색, 보완) 관련 모든 함수가 ror 인수를 포함합니다. 또한, desc_add_ror()라는 새로운 함수가 만들어졌습니다. 예를 들어 ROR ID를 저자 항목에 추가하려면 다음을 사용합니다. desc::desc_add_ror("019jywm96", given = "rOpenSci") ROR ID가 포함된 저자 항목을 추가하려면 다음을 사용합니다. desc::desc_add_author(given = "rOpenSci", ror = "019jywm96", role = "fnd") 이 함수들은 한 번에 많은 패키지를 업데이트할 때 유용합니다. 패키지를 하나씩 업데이트하더라도 코드 스니펫을 공유하고 적용하는 것이 더 짧습니다. ROR 지원 in {roxygen2} {roxygen2} 패키지는 Hadley Wickham이 유지하며 특별히 포맷된 주석을 사용해 NAMESPACE와 매뉴얼 페이지를 생성합니다. 매뉴얼 페이지 중에는 패키지 수준 문서가 포함될 수 있으며, dev guide에 따라 반드시 포함해야 합니다. usethis::use_package_doc()를 사용해 이러한 페이지를 만들 수 있습니다. 다음 내용이 예시로 추가됩니다. #' @keywords internal "_PACKAGE" ## usethis namespace: start ## usethis namespace: end NULL devtools::document()를 실행하면 ?패키지명에 대한 Rd 파일이 생성되며, 그 내용은 DESCRIPTION에서 가져온 ORCID와 ROR ID를 포함합니다. 이 경우 ROR ID가 URL로 적절히 재포맷되는 것을 확인하려면 roxygen2의 개발 버전을 설치해 볼 수 있습니다. tinkr 패키지의 예시를 참고하세요. ROR 지원 in {pkgdown} {pkgdown} 패키지는 Hadley Wickham이 유지하며 패키지 메타데이터와 문서를 기반으로 문서 웹사이트를 생성합니다. 2.1.2 버전 이후, DESCRIPTION의 ROR ID가 아이콘으로 변환됩니다. tinkr 웹사이트의 사이드바에는 rOpenSci 이름 옆에 ROR 아이콘이 포함됩니다. 현재, CRAN 페이지, pkgdown 웹사이트, 우리 웹사이트 푸터에 나타나는 ROR 아이콘은 파일에서 가져옵니다. Font Awesome 리포지토리에서 ROR 아이콘 요청을 열었으며, 스팀 업버트(👍)로 지원할 수 있습니다. 이 전략은 ORCID에도 적용되었습니다. 이미 더 전문화된 academicons 라이브러리에도 ROR 아이콘이 존재합니다. 결론 이 기술 노트에서는 ROR ID가 무엇인지, 조직을 위한 지속적 ID라는 점을 설명했습니다. 조직이 ROR ID를 사용하면 패키지 DESCRIPTION에 조직을 명확하게 식별할 수 있습니다. 예를 들어, 후원 기관이나 저작권 보유 기관을 명시하는 데 유용합니다. 우리는 조직을 연구 조직 레지스트리에 등록하고 생성된 ID를 패키지 DESCRIPTION에 사용하도록 권장합니다. 이 작업은 패키지 스프링 클리닝 중에 진행될 수 있습니다. 다른 사람의 메타데이터 파일에서 복사‑붙여넣기를 하면서 모두가 정리해 보겠습니다. 현재 CRAN 체크에서는 ROR ID가 포함된 패키지에 NOTE를 표시하지만 무시해도 무방합니다.