[论文解读] Documenting Problem-Solving Knowledge: Proposed Annotation Design Guidelines and their Application to Spreadsheet Tools

Matthew Dinmore|ArXiv.org|Aug 8, 2009

Spreadsheets and End-User Computing参考文献 30被引用 6

一句话总结

本文提出了一种三层次注释模型及设计指南，用于终端用户编程环境，以使软件工件中的隐性问题求解知识显性化。应用于电子表格时，该框架使用户能够通过结构化注释记录逻辑与意图，从而在终端用户开发场景中提升可维护性与知识共享能力。

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.

研究动机与目标

• 解决隐性问题求解知识隐藏在终端用户软件工件中的挑战。
• 设计一种结构化注释模型，以支持在终端用户程序中显式记录推理与逻辑。
• 开发支持文献化与显式注释的终端用户编程环境的实际设计指南。
• 评估该注释模型在电子表格工具背景下的可行性与实用性。
• 通过使终端用户开发的逻辑更加透明，提升软件可维护性与知识传递能力。

提出的方法

• 提出三层次注释模型：显式（直接注释）、文献化（叙述性解释）和上下文化（嵌入代码或数据结构中）。
• 基于认知与可用性原则，为终端用户编程环境开发设计指南，以支持在所有三个层次上进行注释。
• 将该模型与指南应用于电子表格环境，使用户能够为单元格、公式和工作表添加目的与逻辑注释。
• 采用基于案例的方法，展示注释如何自然地融入电子表格开发的日常工作流。
• 强调可用性与集成性，确保注释不会干扰主要编程任务。
• 利用现有的电子表格交互模式，最大限度降低终端用户的学习成本。

实验结果

研究问题

• RQ1 如何使终端用户软件中的问题求解知识显性化并可访问？
• RQ2 哪些设计原则能支持在终端用户编程环境中实现有效注释？
• RQ3 如何对注释进行结构化设计，以在电子表格应用中同时支持清晰性与可维护性？
• RQ4 不同层次的注释（显式、文献化、上下文化）在提升对终端用户开发逻辑的理解方面发挥什么作用？
• RQ5 注释指南能否在现实世界电子表格开发工作流中实际应用？

主要发现

• 三层次注释模型能有效在不同详细程度与上下文下组织问题求解知识。
• 设计指南显著提升了注释在终端用户编程环境中可用性与集成性。
• 应用于电子表格的案例表明，注释可自然嵌入而不会破坏工作流。
• 该模型通过使逻辑与意图对未来的开发者或同一工件的使用者可见，提升了可维护性。
• 该方法支持知识共享，并降低了因对公式或数据逻辑误解而导致错误的风险。
• 该框架为支持将文档作为终端用户开发中首要关注点的工具奠定了基础。