• Corpus ID: 15159871

Documenting Problem-Solving Knowledge: Proposed Annotation Design Guidelines and their Application to Spreadsheet Tools

@article{Dinmore2009DocumentingPK,
  title={Documenting Problem-Solving Knowledge: Proposed Annotation Design Guidelines and their Application to Spreadsheet Tools},
  author={Matthew Dinmore},
  journal={ArXiv},
  year={2009},
  volume={abs/0908.1192}
}
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… 

Figures from this paper

Towards User Assistance for Documents via Interactional Semantic Technology
TLDR
This work argues that high-impact documents require embedded user assistance facilities for their readers (not authors) to cope with their semantic complexity, and suggests to illustrate such documents and their players with a semiformal background ontology, an interpretation mapping between domain concepts and semantic objects.
Spreadsheets with a Semantic Layer
TLDR
In the SACHS project, a semantic layer is added to spreadsheets with a semi-formal domain ontology and equip them with a semantically transparent interface that allows new forms of interaction like “semantic navigation’, “framing”, or “playing with variants”.
What we understand is what we get: Assessment in Spreadsheets
TLDR
This paper evaluates the (comprehension) coverage of SACHS on an Excel-based financial controlling system via a "Wizard-of-Oz" experiment, and shows that SAC HS adds significant value, but systematically misses important classes of explanations.
On the Interpretation of Spreadsheets within their Environment
TLDR
This work employs indexes to generate a list of relevant evidence that is hyperlinked to the context in which the evidence is discussed, and contends that these presentational differences aid the integrity and understanding of complex models.
Introducing Morphit, a new type of spreadsheet technology
TLDR
A new type of spreadsheet which mitigates the errors caused by incorrect range referencing in formulae, composed of structured worksheets called tables which contain a hierarchical organization of fields.
Awareness and Control for Inter-Widget Communication: Challenges and Solutions
TLDR
This paper analyzes the problem space and evaluates possible solutions to improve user perception of inter-widget communication (IWC), and offers a discussion of promising techniques and pending challenges.

References

SHOWING 1-10 OF 57 REFERENCES
Literacy for the Masses: Integrating Software and Knowledge Reuse for End-User Developers Through Literate Programming
We examine the potential for applying the literate programming approach to end-user development problems in which explicit knowledge capture and sharing is an objective. Research results from the
Cognitive tools for locating and comprehending software objects for reuse
TLDR
It is shown that high functionality computer systems by themselves do not provide sufficient support for software reuse, and two systems that support this framework, CODEFINDER and EXPLAINER are presented.
End-user software engineering with assertions in the spreadsheet paradigm
TLDR
An approach for supporting assertions in end-user software, focusing on the spreadsheet paradigm is described, and results show that the end users were able to use the assertions to reason about their spreadsheets, and that doing so was tied to both greater correctness and greater efficiency.
It Ain't What You View, But The Way That You View It: documenting spreadsheets with Excelsior, semantic wikis, and literate programming
I describe preliminary experiments in documenting Excelsior versions of spreadsheets using semantic wikis and literate programming. The objective is to create well-structured and comprehensive
The relevance of software documentation, tools and technologies: a survey
This paper highlights the results of a survey of software professionals. One of the goals of this survey was to uncover the perceived relevance (or lack thereof) of software documentation, and the
API documentation from source code comments: a case study of Javadoc
This paper describes in a general way the process we went through to determine the goals, principles, audience, content and style for writing comments in source code for the Java platform at the Java
A study of the documentation essential to software maintenance
TLDR
The results of a survey of software maintainers are presented to try to establish what documentation artifacts are the most useful to them.
What Makes End-User Development Tick? 13 Design Guidelines
TLDR
This chapter presents design guidelines that cut across a variety of application domains based on the experience with the AgentSheets end-user simulation-authoring tool, and claims that every end- user development system should attempt to keep the learning challenges in proportion to the skills end-users have.
End-user software engineering
TLDR
This work has been investigating ways to address the problem of dependability in end-user programming by developing a software engineering paradigm viable for end- user programming, an approach it is called end-users software engineering.
Theme-based literate programming
TLDR
The development of theme-based literate literate programming (TBLP) is reported, which provides flexibility and extensibility, allowing users to define new chunk types.
...
...