Good documentation offers the promise of enabling developers to easily understand design decisions. Unfortunately, in practice, design documents are often rarely updated, becoming inaccurate, incomplete, and untrustworthy. A better solution is to enable developers to write down design rules which are checked against code for consistency. But existing rule checkers require learning specialized query languages or program analysis frameworks, creating a barrier to writing project-specific rules. We introduce two new techniques for authoring design rules: snippet-based authoring and semi-natural-language authoring. In snippet-based authoring, developers specify characteristics of elements to match by writing partial code snippets. In semi-natural language authoring, a textual representation offers a representation for understanding design rules and resolving ambiguities. We implemented these approaches in RulePad. To evaluate RulePad, we conducted a between-subjects study with 14 participants comparing RulePad to the PMD Designer, a utility for writing rules in a popular rule checker. We found that those with RulePad were able to successfully author 13 times more query elements in significantly less time and reported being significantly more willing to use RulePad in their everyday work.
Fri 13 Nov Times are displayed in time zone: (UTC) Coordinated Universal Time change
01:30 - 02:00: DocumentationPaper Presentations / Research Papers / Visions and Reflections / Journal First / Tool Demos at Virtual room 1 | |||
01:30 - 01:32 Talk | Beyond Accuracy: Assessing Software Documentation Quality Visions and Reflections Christoph TreudeUniversity of Adelaide, Australia, Justin Middleton North Carolina State University, USA, Thushari AtapattuThe University of Adelaide DOI | ||
01:33 - 01:34 Talk | Contextual Documentation Referencing on Stack Overflow Journal First Sebastian Baltes QAware GmbH and The University of Adelaide, Christoph TreudeUniversity of Adelaide, Australia, Martin RobillardMcGill University Pre-print | ||
01:35 - 01:36 Talk | DeepCommenter: A Deep Code Comment Generation Tool with Hybrid Lexical and Syntactical Information Tool Demos Boao LiZhejiang University, China, Meng YanChongqing University, Xin XiaMonash University, Xing HuPeking University, Ge LiPeking University, David LoSingapore Management University DOI | ||
01:37 - 01:38 Talk | Docable: Evaluating the Executability of Software Tutorials Research Papers Samim MirhosseiniNorth Carolina State University, USA, Chris ParninNorth Carolina State University, USA DOI Pre-print | ||
01:39 - 01:40 Talk | RulePad: Interactive Authoring of Checkable Design Rules Research Papers Sahar MehrpourGeorge Mason University, USA, Thomas LaTozaGeorge Mason University, USA, Hamed SarvariGeorge Mason University, USA DOI Pre-print | ||
01:41 - 01:42 Talk | Software Documentation and Augmented Reality: Love or Arranged Marriage? Visions and Reflections Sridhar ChimalakondaIndian Institute of Technology Tirupati, Akhila Sri Manasa VenigallaIIT Tirupati, India DOI | ||
01:43 - 02:00 Talk | Conversations on Documentation Paper Presentations Akhila Sri Manasa Venigalla, Christoph TreudeUniversity of Adelaide, Australia, Sahar MehrpourGeorge Mason University, USA, Samim MirhosseiniNorth Carolina State University, USA, Sridhar ChimalakondaIndian Institute of Technology Tirupati, M: Venera ArnaoudovaWashington State University |