[논문 리뷰] Documenting Problem-Solving Knowledge: Proposed Annotation Design Guidelines and their Application to Spreadsheet Tools

Matthew Dinmore|ArXiv.org|2009. 08. 08.

Spreadsheets and End-User Computing참고 문헌 30인용 수 6

한 줄 요약

이 논문은 소프트웨어 자산 내의 암묵적인 문제 해결 지식을 명시적으로 드러내기 위해 종량자 프로그래밍 환경을 위한 3단계(annotation) 모델과 설계 지침을 제안한다. 스프레드시트에 적용할 경우, 이 프레임워크는 사용자가 논리와 의도를 구조화된 주석을 통해 문서화할 수 있게 하여 종량자 개발 환경에서 유지보수성과 지식 공유를 향상시킨다.

ABSTRACT

End-user programmers create software to solve problems, yet the problem-solving knowledge generated in the process often remains tacit within the software artifact. One approach to exposing this knowledge is to enable the end-user to annotate the artifact as they create and use it. A 3-level model of annotation is presented and guidelines are proposed for the design of end-user programming environments supporting the explicit and literate annotation levels. These guidelines are then applied to the spreadsheet end-user programming paradigm.

연구 동기 및 목표

• 종량자 소프트웨어 자산 내에 숨겨진 암묵적인 문제 해결 지식의 과제를 해결하기 위해.
• 종량자 프로그램 내의 추론과 논리에 대한 명시적 문서화를 지원하는 구조화된 주석 모델을 설계하기 위해.
• 기록적이고 명시적인 주석을 지원하는 종량자 프로그래밍 환경을 위한 실용적인 설계 지침을 개발하기 위해.
• 스프레드시트 도구의 맥락에서 주석 모델의 타당성과 유용성을 평가하기 위해.
• 종량자 개발된 논리를 더 투명하게 만들어 소프트웨어 유지보수성과 지식 이관을 향상시키기 위해.

제안 방법

• 3단계 주석 모델을 제안: 명시적(직접적인 주석), 기록적(내용 설명), 맥락적(코드 또는 데이터 구조에 통합된 주석).
• 인지 및 사용성 원칙을 바탕으로 종량자 프로그래밍 환경을 위한 주석 지원을 위한 설계 지침을 개발.
• 스프레드시트 환경에 모델과 지침을 적용하여 사용자가 셀, 수식, 시트에 목적과 논리를 주석으로 기록할 수 있도록 한다.
• 사례 기반 접근 방식을 사용하여 주석이 스프레드시트 개발의 자연스러운 워크플로우에 어떻게 통합될 수 있는지 보여준다.
• 사용성과 통합을 강조하여 주석이 주요 프로그래밍 작업을 방해하지 않도록 한다.
• 기존의 스프레드시트 상호작용 패턴을 활용하여 종량자 사용자가 학습 부담을 최소화할 수 있도록 한다.

실험 결과

연구 질문

• RQ1 종량자 소프트웨어 내 문제 해결 지식을 어떻게 명시적이고 접근 가능하게 만들 수 있는가?
• RQ2 종량자 프로그래밍 환경에서 효과적인 주석을 지원하는 설계 원칙은 무엇인가?
• RQ3 주석을 어떻게 구조화하여 스프레드시트 응용 프로그램에서 명확성과 유지보수성 모두를 지원할 수 있는가?
• RQ4 명시적, 기록적, 맥락적 주석의 다양한 수준이 종량자 개발 논리 이해를 어떻게 향상시키는가?
• RQ5 주석 지침은 실제 스프레드시트 개발 워크플로우에 실질적으로 적용될 수 있는가?

주요 결과

• 3단계 주석 모델은 다양한 세부 수준과 맥락에서 문제 해결 지식을 효과적으로 체계화한다.
• 설계 지침은 종량자 프로그래밍 환경에서 주석의 사용성과 통합 수준을 크게 향상시킨다.
• 스프레드시트에 적용한 결과, 주석이 워크플로우를 방해하지 않도록 자연스럽게 통합될 수 있음을 입증한다.
• 논리와 의도가 향후 개발자나 동일 자산의 사용자에게 명확하게 드러나므로 유지보수성이 향상된다.
• 지식 공유를 지원하고 수식이나 데이터 논리의 오해로 인한 오류 위험을 줄인다.
• 이 프레임워크는 종량자 개발에서 문서화를 핵심 고려사항으로 삼는 도구 개발을 위한 기반을 제공한다.