코드-문서 등가성을 통한 자연어 중심 소프트웨어 공학

소스 코드 문서화 (Source code documentation)는 코드를 이해하는 데 도움을 주고 개발자 간의 의사소통을 용이하게 하므로, 소프트웨어 개발 및 유지보수의 필수적인 부분입니다. 그러나 기존의 문서들은 종종 불완전하거나, 시대에 뒤처지거나, 부정확하며, 이는 오해와 오류로 이어질 수 있습니다. 소프트웨어 공학 (Software engineering) 작업에 광범위하게 사용되고 있는 대규모 언어 모델 (LLMs) 시대에는 문서가 모델에 중요한 문맥 (Context)을 제공하기 때문에 문서의 품질이 더욱 중요해집니다. 본 논문에서는 문서가 설명하는 코드를 정확하고 완전하게 기술하는지를 포착하는 새로운 속성인 문서-코드 등가성 (Documentation-to-code equivalence)이라는 개념을 소개합니다. 우리는 주어진 코드 스니펫 (Code snippet)에 대해 등가적인 문서를 자동으로 생성하는 Documentary라고 불리는 새로운 접근 방식을 제시합니다. 우리의 평가에 따르면, Documentary는 평가된 함수 수준 (Function-level) 코드 스니펫의 53.4%에 대해 등가적인 문서를 생성할 수 있습니다. 문서-코드 등가성의 이점을 보여주기 위해, 우리는 코드 이해 (Code understanding) 및 코드 편집 (Code editing)이라는 두 가지 소프트웨어 공학 작업을 설명하고 평가합니다. 우리의 결과는 문서-코드 등가성을 사용할 때, LLM이 사람이 작성한 문서 및 베이스라인 (Baseline) 접근 방식으로 생성된 문서와 비교했을 때 함수의 출력을 12.8--24.5% 더 높은 정확도로 예측할 수 있음을 보여줍니다. 또한, 인간 개발자들은 Documentary에 의해 생성된 문서가 기존의 사람이 작성한 문서보다 코드를 이해하고 편집하는 데 더 유용하다고 간주합니다.